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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Speci.cation (TS) has been produced by the Joint Technical Committee (JTC) Broadcast of the European 
Broadcasting Union (EBU), Comite Europeen de Normalisation ELECtrotechnique (CENELEC) and the European 
Telecommunications Standards Institute (ETSI). 

NOTE: The EBU/ETSI JTC Broadcast was established in 1990 to co-ordinate the drafting of standards in the 

specific field of broadcasting and related .elds. Since 1995 the JTC Broadcast became a tripartite body by 
including in the Memorandum of Understanding also CENELEC, which is responsible for the 
standardization of radio and television receivers. The EBU is a professional association of broadcasting 
organizations whose work includes the co-ordination of its members' activities in the technical, legal, 
programme-making and programme-exchange domains. The EBU has active members in about 60 
countries in the European broadcasting area; its headquarters is in Geneva. 

European Broadcasting Union 

CH-1218 GRAND SACONNEX (Geneva) 

Switzerland 

Tel: -1-41 22 717 21 11 

Fax: -1-41 22 717 24 81 

Founded in September 1993, the DVB Project is a market-led consortium of public and private sector organizations in 
the television industry. Its aim is to establish the framework for the introduction of MPEG-2 based digital television 

services. 

Now comprising over 200 organizations from more than 25 countries around the world, DVB fosters market-led 
systems, which meet the real needs, and economic circumstances, of the consumer electronics and the broadcast 
industry. 



Introduction 

0.1 Purpose 

The DVB system already provides a comprehensive toolbox to enable interoperable digital video broadcasting systems 
based on MPEG-2 standards for various transmission media including satellite, cable, terrestrial and microwave. This 
toolbox also covers interactive services using different kinds of return channels and further supporting functionalities 
such as service information and many others. 

The Multimedia Home Platform (MHP) adds a technical solution for the user terminal that enables the reception and 
presentation of applications in a vendor, author and broadcaster neutral framework. Here "neutral" includes scenarios 
that consider legacy infrastructure. Applications from various service providers will be interoperable with different 
MHP implementations in an horizontal market, where applications, networks, and MHP terminals can be made 
available by independent providers. 
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0.2 Application areas 



At the beginning the following application areas are considered - Enhanced Broadcasting, Interactive Broadcasting and 
Internet Access. Enhanced Broadcasting combines digital broadcast of audio/video services with downloaded 
applications which can enable local interactivity. It does not need an interaction channel. The application area Interactive 
Broadcasting enables a range of interactive services associated or independent from broadcast services. This application 
area requires an interaction channel. The application area of Internet Access is intended for the provisioning of Internet 
services. It also includes links between those Internet services and broadcast services. 



0.3 



Profiles 



As not all MHP implementations will be able to support all application areas and as there is a further evolution expected 
over time, different profiles of the MHP are considered. For the first release of the MHP specification, profiles are 
mapped to the above mentioned application areas. 



Levels 



Enhanced 

Broadcasting 2 

Profile 


Interactive 

Broadcasting 2 

Profile 


Internet 

Access 2 

Profile 








Enhanced 

Broadcasting 1 

Profile 


Interactive 

Broadcasting 1 

Profile 


Internet 

Access 1 

Profile 



Application Areas 
Figure 1 : Application areas and levels of profiles 

Fig. 1 shows six example profiles, derived from two levels for each of the three application areas. The specific definition 
of the profiles and the particular backward and cross compatibility between profiles is provided in the detailed profile 
definition chapter of the MHP specification. The following initial definitions apply: <profile><n+l> shall be a strict 
superset of <profile><n>, and Interactive Broadcasting Profile lis defined as a strict superset of Enhanced Broadcasting 
Profile 1. Other dependencies are left to the detailed definition of future profiles. 
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1 



Scope 



The present document defines the DVB solution for Muhimedia Home Platforms (MHPs) that was developed to fiilfil the 
related DVB commercial requirements MHP045 [A]. It relies on the use of appropriate DVB specifications for digital 
video broadcast and associated interactive services ETSI TR 101 200 [47]. The MHP is applicable to all DVB defined 
transmission media and networks such as satellite, cable, terrestrial, microwave. 

The final DVB MHP solution is intended to cover the whole range of implementations including Integrated Receiver 
Decoders (IRDs), integrated TV sets, multimedia computers and local clusters of such devices coimected via In-Home 
Digital Networks (IHDN). This first release focuses on single MHP terminals and does not include such local clusters. 
Chapters 1-14 specify the applicable technologies and technical definitions in a generic way. Chapter 15 provides 
detailed profile definitions for the initial profiles Enhanced Broadcasting 1 and Interactive Broadcasting 1 , which can be 
extended with future additional profile definitions. 

This specification is firstly intended for implementers of MHPs on various hardware and software platforms. Secondly it 
is intended for developers of applications that use the MHP functionality and APIs. 

The MHP specification aims to ensure interoperability between MHP applications and different MHP implementations. 
Implementers should consult the publisher of this specification regarding conformance. 

NOTE: This specification defines the interfaces visible to applications. Application developers should not 
assume that other related interfaces are available unless they are specifically listed. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication and/or edition number or version number) or non- 
specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

Some known errata in these references are identified in A, "(normative): External references; errata, clarifications and 
exemptions" on page 236. These errata take precedence over the published reference. 

The following comments apply to particular sources of documents: 



[1] 



Where the reference is to an ISO specifications it is considered to be a "non- 
specific" reference additionally officially published amendments and corrigenda are 
considered to automatically update the referenced document. 



[2] 



Where an ISBN number is provided for a referenced document it is considered to 
be "specific reference". 



[3] 



References to RFCs are considered to be "specific references". 

An RFC being indicated obsoleted by another RFC is not considered significant. 



[4] 



URL references with note [4] are provided for convenience to access the document 
in electronic form. 



[5] 



URL references with note [5] are the normative method to access the reference 
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[6] 



ETSI specifications are available from the ETSI server at: http://www.etsi.org . 
However, the ETSI server provides the current edition of the specification and in 
every case this specification makes "specific" references which in the future may 
not be the current reference. 



[7] 



The Sun Specifications for DVB are available from: 

http://iava.sun.com/products/specformhp/ 
or on CD-ROM (ISBN 1-892488-25-6) published by: 

Sun Microsystems 

MSUSCA14-103 

Palo Alto 

CA 94303 

USA 

e-mail: docs@iava.sun.com 

Phone: +1 408 276-7426 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

API: Application Program Interface. An interface between an application and a particular feature, function or resource of 
the MHP. 

application: A functional implementation realised as software running in one or spread over several interplaying 
hardware entities. 

application boundary: A concise general description of the data elements (HTML documents, code files, images etc.) 
used to form one application and the logical locator of the entry point, the application boundary is described by a regular 
expression over the URL language. Where no such boundary is drawn, the default boundary shall be the entire set of 
documents that the MHP platform can access. 

application instance: A unique invocation of an application, i.e. running the same application twice results in two 
distinct application instances. 

application manager: The Application Manager is the entity in the MHP that is responsible for managing the lifecycle 
of the applications in the MHP. It manages both the DVB-J applications and non-DVB-J applications. 

autostart applications: This terms has different definitions depending on the application format: 

A DVB-J autostart application is an application that is automatically loaded and executed by the Application Manager as 
soon as the user selects a service on which the application is signalled as autostart. 

Auto start application a DVB-HTML application in a broadcast stream can be signalled as auto start in the same way that 
other DVB applications can, but note that it may not actually start providing service until it receives a start trigger. 

best effort: an implementation dependent approximation which is as close as reasonable to what has requested in the 
circumstances concerned. 

character: A specific "letter" or other identifiable symbol, e.g. "A". 

character encoding: A character encoding is a mapping between an integer input value, and the textual character that is 
represented by this mapping, e.g. in ASCII value 65 (decimal) is character "A", or shift- JIS for Japanese characters. 

character set: See character encoding. 

communications network: A system of interconnected entities providing data interchange between points or from a 
point to multiple points. 

domain of an application: The domain of an Xlet characterizes the "space" within which the Xlet is able to execute. 
This includes both the "connection" where the Xlet is delivered and other "connections" where an already executing Xlet 
is allowed to continue executing. 

An application cannot run outside its domain. The maximum lifetime of an application extends from the moment the user 
navigates to its domain until the moment that the user navigates away from its domain. 

In the broadcast case a "connection" corresponds to a DVB-service. Broadcast signalling indicates which services can 
load an application and which services allow an already active application to continue. 

DVB network: A collection of MPEG-2 Transport Stream multiplexes transmitted on a single delivery system, e.g. all 
digital channels on a specific cable system. 

DVB-HTML actor: A DVB-HTML actor is defined as the locus of activity or process involved in running the specific 
set of DVB-HTML documents for some DVB-HTML application, plus any instantiated context for that data. The actor 
runs inside a user agent (native, plug-in or downloaded). The nature of the process is not defined explicitly as it depends 
on the nature of the user agent itself. More than one such locus of activity may be present in any given user agent. 
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DVB-HTML application: A DVB-HTML application is defined as a set of documents selected from the DVB-HTML 
family of elements and content formats as defined in the specification. The extent of the set is described by the 
application boundary. 

DVB-HTML application states: DVB-HTML application states are logical states that a DVB-HTML actor can be in, 
(as opposed to states the user agent may be in), these states may have instance data logically associated with them (e.g. 
the application id and entry point). 

DVB-HTML document: A complete unit of one the HTML family of elements or content formats defined in this 
specification. 

DVB- J: The Java platform defined as part of the MHP specification. 

DVB- J API: One of the Java APIs standardised as part of the MHP specification. 

DVB- J application: A DVB- J Application is a set of DVB-J classes that operate together and need to be signalled as a 
single instance to the Application Manager so that it is aware of its existence and can control its lifetime through a 
lifecycle interface. 

events: Asynchronous communication between applications and the MHP on which they are being executed. They 
provide communication between solution elements. 

font: A font is a mechanism that allows the specific rendering of a particular character to be specified - e.g. Tiresias, 12 
point. In practice a font file format will incorporate some aspects of a character encoding. 

function: A function is a process which conveys or transforms data in a predictable way. It may be effected by hardware, 
software of a combination of the two. 

hardware entity: Is an independent piece of hardware which forms part of a (multiple) local cluster of elements which 
as a whole is called MHP. A hardware entity is for example: a Set top box, a digital VCR or a conditional access module. 
A hardware entity includes a number of resources. Each resource provides a number of functions. 

interoperability: The reception and presentation of applications in a vendor, author and broadcaster neutral framework 
(FromMHP45rl2). 

Java API: Is a standard interface for use by platform independent application software. It is expressed in the Java 
language. 

lifetime of an application: The lifetime of an application characterizes the time from which the application is Loaded to 
the time the application is Destroyed. 

locator: This term has different definitions depending on the application format: 

A DVB-HTML locator is a link, expressed in the syntax in IETF RFC 2396 [41], which provides an unambiguous 
pointer to a DVB-HTML document accessible to the MHP in a specific transport stream. The scheme specified should 
resolve to one of the available transports signalled for the DVB-HTML application. For signed DVB-HTML applications 
the schemes http and https (ftp, others?) may use the return channel. This version of the specification does not include a 
scheme for transport independent locators, fliture versions are expected to do so. 

This term in the DVB-HTML context should not be confused with the DVB-J class of the same name. 

MHP: The Multimedia Home Platform (MHP) consists of an MHP viewer terminal, including all possible low to high 
functionality implementations, its associated peripherals and the in-home digital network. 

MHP connected resource: A resource used as part of the MHP which, on its own, is not conformant to the specification 
but which is connected to an MHP Terminal in such a way that the whole is part of the MHP. 

MHP service: A logical service in an MHP which can be selected through the service selection API or functional 
equivalents. This includes broadcast DVB services and extensions defined in future versions of this specification. 

MHP solution: The MHP solution encompasses the whole set of technologies necessary to implement the MHP 
including protocols and APIs. 
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MHP terminal: A single piece of physical equipment confonning to the MHP specification, in particular in that it 
contains a Virtual Machine and an instance of the MHP API. 

navigator: A resident application, typically provided by the manufacturer, which the end-user can activate at any time. 
The navigator can be used to select services, applications, and initiate Interoperable applications. 

object carousel: A repetitively broadcast file system. 

OID: X.509 Object Identifier 

persistent storage: Memory available in the MHP which can be read/written to by an application and which may outlive 
the application's own life. 

Persistent storage shall be non-volatile. 

plug-in: A set of functionality which can be added to a generic platform in order to provide interpretation of DVB 
registered, but non-DVB-J, application formats; e.g. HTML3.2 or MHEG-5. 

profile: A description of a series of minimum configurations, defined as part of the specification, providing different 
capabilities of the MHP. It maps a set of functions which characterise the scope of service options. The number of 
profiles is small. The mapping of functions into resources and subsequently into hardware entities is out of the scope of 
the specification and is left to manufacturers. 

regular expression: A method of capturing a large, possibly infinite set of strings in a compact representation. 

resident application: An application available from non-volatile storage in an MHP device which may be expressed in 
DVB-J but need not be so. Its delivery route is not specified. 

resource: Is a well defined capability or asset of a system entity, which can be used to contribute to the realisation of a 
service. Examples: MPEG decoder, Graphics system. 

return channel: The communications mechanism which provides connection between the MHP and a remote server. 

sandbox: Unsigned applications and signed applications without a permission file have access to all the APIs for which 
there is no permission signalling defined. This is commonly called the sandbox. 

service: A sequence of programs under the control of a broadcaster which can be broadcast as part of a schedule. 

service component: A part of a service. For a DVB service, service components are normally the MPEG elementary 
streams listed in the PMT for the service. Where multiple streams of subtitles or MPEG-2 audio representing different 
languages are carried in the same MPEG elementary stream these are logically service components but are not exposed 
through the MHP APIs as being distinct and separate. 

stream: A unidirectional continuous flow of content. Example: MPEG2 video. 

system software: Software implementation below the API for a specific platform entirely under control of the 
manufacturer. 

trigger: A trigger is an event that may cause a change in the behaviour of a DVB-HTML application that registers 
interest in such events. Triggers may come from many sources e.g. the broadcast stream, or may be generated from other 
data (such as the system clock), or may be generated as a result of user interaction. The trigger may include a reference to 
time, which may be absolute (UTC), relative to some other event, relative to the NPT of a media stream. It also can carry 
some semantically significant payload in order to affect changes in an application based on information not available at 
the time an application was written. 

tuning: the act of switching between two MPEG transport streams or multiplexes. Switching between two DVB services 
carried in the same transport stream is not tuning. 

viewer: End-user of the MHP terminal. 

xlet: Interface used for DVB-J application life cycle control. 



ETSI 



39 



ETSITS 101 812V1.3.1 (2003-06) 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



API 

AV 

AWT 

CA 

CI 

GLUT 

DAVIC 

DCT 

DECT 

DOM 

DSM-CC 

DSM-CC-OC 

DSM-CC-UU 

DVB 

ECMA 

EPG 

ETSI 

GIF 

GSM 

GUI 

HTML 

HTTP 

I/O 

IHDN 

IP 

IPR 

IRD 

ISDN 

ISO 

ITU 

JDK 

JFIF 

JMF 

JPEG 

LMDS 

MHEG 

MHP 

MMDS 

MPEG 

OC 

OS 



Application Programming Interface 

Audio Video 

Abstract Windowing Toolkit 

Conditional Access 

Common Interface 

Colour Lookup Table 

Digital Audio Visual Council 

Discrete Cosine Transformation 

Digital Enhanced Cordless Telecommunications 

Document Object Model 

Digital Storage Media - Command and Control 

Digital Storage Media - Command and Control Object Carousel 

Digital Storage Media - Command and Control User to User 

Digital Video Broadcasting 

European Computer Manufacturers Association 

Electronic Program Guide 

European Telecommunications Standards Institute 

Graphics Interchange Format 

Global System for Mobile communications 

Graphical User Interface 

Hyper Text Mark-up Language 

Hyper Text Transport Protocol 

Input / Output 

In Home Digital Network 

Internet Protocol 

Intellectual Property Rights 

Integrated Receiver Decoder 

Integrated Services Digital Network 

International Organization for Standardization 

International Telecommunication Union 

Java Development Kit 

JPEG File Interchange Format 

Java Media Framework 

Joint Picture Expert Group 

Local Multipoint Distribution System 

Multimedia Hypermedia Expert Group 

Multimedia Home Platform 

Multipoint Microwave Distribution System 

Moving Picture Expert Group 

Object Carousel 

Operating System 
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OSD 

PFR 

PMT 

PNG 

PSI 

PSTN 

RAM 

ROM 

SI 

SMATV 

TCP 

TS 

UCS 

UDP 

UI 

URL 

UTF 

uu 

VM 

WAN 



On Screen Display 

Portable Font Resource 

Program Map Table 

Portable Network Graphics 

Program Specific Information 

Public Switched Telephone Network 

Random Access Memory 

Read Only Memory 

Service Information 

Satellite Master-Antenna Television 

Transmission Control Protocol 

Transport Stream 

Universal Multiple-Octet Coded Character Set 

User Datagram Protocol 

User Interface 

Uniform Resource Locator 

UCS Transformation Coding 

User to User 

Virtual Machine 

Wide Area Network 



Conventions 



Unless otherwise specified, the BNF notation in this specification shall follow the definitions of section 2.1 of 
IETF RFC 2616 [40]. 
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Basic Architecture 



5.1 



Context 



At its simplest level, the MHP is set in the following context (see figure 2). The software of the MHP has access to flows 
of streams and data, and may write some data to storage. The platform may be able to route streams and data outwards to 
a sink or store. 




Figure 2 : MHP context 

The platform will receive inputs from Viewer input devices and output communications through a screen or other outputs 
like loudspeakers to present to the viewer. The platform may have access to communications with remote entities. 

The diagram in figure 3 shows a possible set of external interfaces between an MHP and the outside world. This is one 
example only but it serves to illustrate a series of principles. 



User I/O 




Broadcast Network 



Interaction Channel 



Figure 3 : External interfaces between an IVII-IP and the outside world 



The resources of the MHP, accessible by an application, may be contained in a series of different but cormected physical 
entities. 

The local cluster may connect a number of MHP terminals and resources 
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A cluster may also include resources which are not part of the MHP infrastructure and are not available to the 
application. 

The local cluster is understood to be consistent with the DVB IHDN specification. The detailed description of the MHP 
in the local cluster is not in the first version of the specification. 



5.2 



Architecture 



The Architecture describes how the MHP software elements are organized. 
The MHP model considers 3 layers (figure 4): 

• Resources 

• System software 

• Applications 

The API lies between the Applications and the System Software seen from the perspective of an application. 



API 



Application 



Application 



Application 



System software 



Application 
Manager 



Resources 



Figure 4 : Basic architecture 



5.2.1 



Resources 



The hardware entities in the platform include a number of functions. They are represented by hardware or software 
resources. There is no assumption about how they are grouped. The model considers that there can be more than one 
hardware entity in the total Platform. 

From an abstract point of view it makes no difference if the logical resources are mapped into one or several hardware 
entities. What is important is that resources are provided to the MHP transparently. An application should be able to 
access all locally connected resources as if they were elements of a single entity. 

5.2.2 System software 

Applications will not directly address resources. The system software brings an abstract view of such resources. This 
middle layer isolates the application from the hardware, enabling portability of the application. 

The implementations of the Resources and System software are not specified in this document. 

5.2.2.1 Application Manager 

The system software includes an application management function, which is responsible for managing the lifecycle of all 
applications, including Interoperable ones. 

5.2.3 Application 

Applications implement interactive services as software running in one or more hardware entities. The interface for 
MHP applications is a top view from application to the system software. 
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Figure 4 on page 42 illustrates an idealised architecture model of the processes which will occur in an MHP. A hierarchy 
of control is assumed in which each layer controls the processes in adjacent layers. The top layer is responsible for the 
control of the operation via interactive applications. The Application Manager is part of the System Software and as such 
is implementation specific. It interacts with all applications. 

The System Software implements the API by presenting an abstract model of: 

• Streams played from different sources and pipes for conducting them. 

• Commands and events 

• Data records or files 

• The hardware resources 

The API provides the associated services to applications. 

In fact there are many APIs which implement distinct services and interfaces. These are described in detail in the 
specification, either by reference to external documents, or by detailed specification. 

The specification describes the interfaces between the network, the application and the system software of the MHP 
terminal. The implementation of any of these three is not specified in this document. 
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5.3 Interfaces Between an MHP Application and the MHP 
System 

Application(s) use the API to access the actual resources of the receiver, including: databases, streamed media decoders, 
static content decoders and communications. These resources are functional entities of the receiver and may be finally 
mapped onto the hardware of the receiver in some manner. 
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Figure 5 : Interfaces between an MHP application and the MHP system 
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Figure 6 : Interfaces between an MHP application and the MHP system with more details 

The diagrams in figure 5 and figure 6 sliow these interfaces and their relationships to media and information flows within 
an MHP system - excluding any local cluster issues. The first diagram shows a generic MHP, the second a specific 
instance of an enhanced broadcast or interactive TV profile system, with optional additions shown. 

In figure 5 and figure 6, only the border between the application and the rest of the system is in the scope of this 
specification. All the rest of each diagram is implementation dependent and shown for information purposes only. 

5.4 Plug-ins 

A "plug-in" is a set of functionality that can be added to a generic platform in order to provide interpretation of 
application and content formats not specified by this specification to be included in MHP terminals. 

NOTE: Those organisations concerned with interoperation between the standard MHP platform and other 
platforms need to specify the plug-in properly for such platforms. 

The choice of which plug-ins to use must be in the hands of the end-user in order that he can have a choice of sources of 
service. This option can be exercised in a number of ways, including the purchase of equipment with "built-in" plug-in 
functionality, the positive selection of a download, or the automatic selection of a download where there is no memory 
resource limitation. 

The plug-in may stay resident where the design of the platform implementation allows. The MHP including the plug-in 
must behave, once the plug-in is loaded and operational, in the same way as a platform supporting the format of the 
delegated applications without the use of a plug-in. 
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Figure 7 illustrates the position of two types of Plug-in in the MHP. 
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Figure 7 : Illustrative plug-in implementation options 

There are two possible tj^es of Plug-in implementation: 

• Using implementation-specific code (e.g. in native code, or using implementation-specific Java APIs). This is 
called an implementation- specific plug-in, illustrated as plug-in "B" in the figure. 

• An MHP application. This is called an interoperable plug-in, illustrated as plug-in "A" in the figure. 

The internal specification of both plug-ins ("A" and "B") is outside of the scope of this specification. They are illustrated 
to show their relationship to the platform. 

5.4.1 Security Model 

Plug-ins must have sufficient access to the resources in the platform to implement the specification concerned. An 
implementation-specific plug-in may have access to many of the resources of the platform irrespective of the MHP 
security model. All plug-ins are responsible for managing the security of the applications they execute. 

If a plug-ins needs privileged access to resources not available to all downloaded applications (i.e. not in the "sand box") 
in order to provide equivalent fiinction to the "legacy" supported they will require the appropriate authentication. 
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6 Transport Protocols 

6.1 Introduction 



In order to be able to talk to the external world, the MHP has to be able to communicate through different network types. 
This part of the MHP specification deals with the Network Independent Protocols and on the networks as defined in two 
specifications from the DVB project, as specified in ETSI ETS 300 802 [16] and ETSI EN 301 192 [5]. 

The protocols defined in these standards provide a generic solution for a variety of broadcast only and interactive 
services, through the use of DSM-CC User-to-User, Data and Object Carousel protocols, as specified in 
ISO/IEC 13818-6 [26] and support for IP over the interaction channel as well as over the broadcast channel through the 
Muhiprotocol Encapsulation ETSI EN 301 192 [5]. 

Broadcast only services are provided on systems consisting of a downstream channel from the Service Providers to 
Service consumers. 

Interactive services are provided on systems consisting of a downstream channel together with interaction channels. 

There are many possible network configurations covering the currently specified DVB broadcast options including 
satellite, terrestrial, cable, SMATV and MMDS in conjunction with PSTN, ISDN, cable and other interactive channel 
options. 

The network dependent protocols for the interaction channels in the DVB context are specified in 
ETSI ETS 300 800 [14], ETSI ETS 300 801 [15], ETSI EN 301 193 [6], ETSI EN 301 195 [7], ETSI EN 301 199 [8], 
ETSI TR 101 201 [48], ETSI EN 301 790 [82] respectively for CATV, PSTN/ISDN, DECT, GSM, LMDS, SMATV and 
satellite networks. The network dependent protocols work together with the Network Independent Protocols. 

6.2 Broadcast Channel Protocols 

This section deals with the DVB defined or referenced broadcast channel protocols. This chapter does not consider other 
protocols and the APIs that would provide access to them. 

Other protocols and their APIs are considered as extensions to the DVB MHP platform, see H, "(normative): Extensions" 

on page 362. 
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Figure 8 illustrates the set of DVB defined broadcast protocols that are accessible by MHP applications in some or all 
profiles (see 15, "Detailed platform profile definitions" on page 228). The full details of the APIs that provide access to 
these broadcast protocols are in chapter 11, "DVB- J Platfonn" on page 104. 
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Figure 8 : Broadcast Channel Protocol Stack 

Except in the case of MPEG-2 sections (see 6.2.2 "MPEG-2 Sections"), when an MHP application attempts to access 
conditional access scrambled data through one of these broadcast channel protocols, the MHP terminal shall attempt to 
initiate descrambling of this data without the application needing to explicitly ask for it. Attempts to access conditional 
access scrambled data at the level of MPEG-2 sections shall not happen without the application explicitly asking for this. 

6.2.1 MPEG-2 Transport Stream 

MPEG-2 Transport Stream is defined in ISO/IEC 13818-1 [23]. 

6.2.2 MPEG-2 Sections 

MPEG-2 private sections as defined in ISO/IEC 13818-1 [23] is based on the MPEG-2 Transport Stream protocol in 6.2. 
1. 

6.2.3 DSM-CC Private Data 

DSM-CC Private Data protocol as defined in ISO/IEC 13818-6 [26]. 

6.2.4 DSM-CC Data Carousel 

DSM-CC Data Carousel as defined in ISO/IEC 13818-6 [26]. 

6.2.5 DSM-CC User-to-User Object Carousel 

DSM-CC User-to-User Object Carousel protocols as defined in ISO/IEC 13818-6 [26] with the restrictions and 
extensions as defined in ETSI EN 301 192 [5], ETSI TR 101 202 [49] and annex B, "(normative): Object carousel" on 
page 295. 



6.2.5.1 



DVB-J class files 



Java bytecode for each Java class is carried as the content bytes of the BIOP::FileMessage corresponding exactly to the 
contents of a "class" file as specified in Java VM [34]. 
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6.2.5.2 DVB-HTML document files 

The set of documents defining a DVB-HTML application is transported with the content bytes of BIOP::FileMessage 
messages corresponding exactly to the contents of the documents (i.e. the BIOP::FileMessage doesn't include any HTTP 
headers, etc.). 

6.2.5.3 Loss of Carousel Behaviour 

Under some conditions, carousel data streams servicing broadcast file systems may become unavailable. The conditions 
for permanent loss of carousel are defined in B.2.1 1, "Unavailability of a carousel" on page 321. The conditions for 
temporary discormection and recormection of carousel are defined in 9. 1 .5, "Persistence of Applications Across Service 
Boundaries" on page 62. 

When this happens, implementations may continue to provide data from carousels which have been lost where they have 
that data cached. The extent of this is clearly implementation dependent. It is also implementation dependent how this 
changes with time. Permanently lost carousels shall never be restored automatically. Temporary discoimections and 
reconnections are automatic and are largely invisible to the application. However, implementations must preserve Java 10 
semantics. For example, the InputStream. available ( ) method should accurately report the number of bytes 
available without blocking. 

Data not in such a cache shall be unavailable to applications. When applications attempt to access unavailable data from 
permanently lost carousels, the operation shall fail. The failure mode shall be one appropriate to the content format and 
the mechanism being used to access the data. 

Failure modes for DVB-J applications are defined in 1 1.5.1.3, "Behaviour following loss of a broadcast carousel" on 
page 124. 

When an application attempts to access unavailable data from a temporarily disconnected carousel, the operation shall 
block until the data becomes available, or it is interrupted. This includes any operations that indirectly cause synchronous 
loading operations, as stated in 11.5.1.1, "Constraints on the java.io.File methods for broadcast carousels" on page 123. 

Upon recormection to a carousel, the system shall start fetching any outstanding data. Any blocked I/O operations shall 
return once the data is received. 

A temporarily disconnected service may become permanently lost if the system determines that the loss of connection is 
irrecoverable - as stated in P, "(nonnative): Broadcast Transport Protocol Access" on page 549, org.dvb.dsmcc. 
ServiceDomain. The cases in which this may occur are: 

• The carousel becomes permanently unavailable, as stated in B.2.1 1, "Unavailability of a carousel" on page 321. 

• The period since the carousel became disconnected is at least 60 seconds. 

If this occurs, any blocked I/O operations shall terminate with Inter ruptedlOExcept ion and the 
ServiceDomain shall enter the detached state. An implementation may choose to use longer timeouts other strategies 
to determine when to permanently lose carousels, within the constraints listed above. For example, boot carousels for 
rurming applications may be kept in preference to carousels mounted by applications. 

6.2.6 DVB Multiprotocol Encapsulation 

DVB Multiprotocol Encapsulation as defined in ETSI EN 301 192 [5] provides support for IP and is based on the DSM- 
CC Private Data protocol. 

6.2.7 Internet Protocol (IP) 

Internet Protocol as defined in IETF RFC 791 [43]. 

6.2.8 User Datagram Protocol (UDP) 

User Datagram Protocol as defined in IETF RFC 768 [42]. 

6.2.9 DVB Service Information 

DVB Service Information as defined in ETSI EN 300 468 [4] and ETSI ETR 21 1 [1 1]. 
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6.2.10 IP signalling 

IP Notification Table (INT) as defined in ETSI EN 301192 [5]. 



6.3 



Interaction Channel Protocols 



This section deals with the DVB defined or referenced interaction channel protocols. This chapter does not consider other 
protocols and the APIs that would provide access to them. Other private protocols and possibly APIs are not precluded 
and are outside of the scope of the MHP 

Figure 9 illustrates the set of DVB defined interaction channel protocols that are accessible by MHP applications in some 
or all profiles (see 15, "Detailed platform profile definitions" on page 228). The full details of the APIs that provide 
access to these interaction protocols are in chapter 1 1, "DVB-J Platform" on page 104. 
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Figure 9 : Interaction Channel Protocol Stack 

6.3.1 Network Dependent Protocols 

As defined in ETSI ETS 300 800 [14], ETSI ETS 300 801 [15], ETSI EN 301 193 [6], ETSI EN 301 195 [7], 
ETSI EN 301 199 [8], ETSI TR 101 201 [48], ETSI EN 301 790 [82] respectively for CATV, PSTN/ISDN, DECT, 
GSM, LMDS SMATV and satellite networks. 

For connection based interaction channels, the PPP protocol is used as defined in IETF RFC 1332 [88], 
IETF RFC 1661 [89], IETF RFC 1717 [90]. Network supphed DNS server addresses shall be supported as in 
IETF RFC 1877 [87]. 

6.3.2 Internet Protocol (IP) 

Internet Protocol as defined in IETF RFC 791 [43]. 

6.3.3 Transmission Control Protocol (TCP) 

Transmission Control Protocol as defined in IETF RFC 793 [44]. 

6.3.4 UNO-RPC 

The UNO-RPC consists of the Internet Inter-ORB Protocol (HOP) as specified in CORBA/IIOP [2]. 
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6.3.5 UNO-CDR 

The UNO-CDR as defined in CORBA/IIOP [2]. 

6.3.6 DCM-CC User to User 

DSM-CC User-to-user as defined in ISO/IEC 13818-6 [26] with the restrictions and extensions as defined in 
ETSI EN 301 192 [5] andETSl TR 101 202 [49]. 

6.3.7 Hypertext Transfer Protocol (HTTP) 
6.3.7.1 HTTP 1.1 

Hypertext Transfer Protocol as defined in IETF RFC 2616 [40]. 

6.3.8 Service Specific 

Service Specific protocols are proprietary protocols used by a service as defined in the guidelines for the Data Broadcast 
Specification ETSI TR 101 202 [49]. The DVB provides a registry mechanism for new, proprietary broadcast protocols. 

6.3.9 User Datagram Protocol (UDP) 

User Datagram Protocol as defined in IETF RFC 768 [42]. 

6.3.10 DNS 

MHP terminals shall implement at least the DNS resolver protocols that enable forward translation of fully qualified 
domain names to IP addresses as defined by IETF RFC 1034 [83] and IETF RFC 1035 [84] and clarified by 
IETF RFC 1982 [85] and IETF RFC 2181 [86]. 

In connection based return channels, where DNS server addresses are provided both from the network as part of 
connection setup and from an MHP application, those provided from the network shall take precedence. 
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7 Content formats 

7.1 Static formats 

7.1.1 Bitmap image formats 

7.1 .1 .1 Image encoding restrictions 

Any indications in the transmitted image with respect to pixel scaling, colour space or gamma are to be ignored in the 
presenting of the image. One image pixel shall be mapped to one graphics pixel in the current graphics configuration, 
unless otherwise scaled by the application directly. 

See also 7.5, "Colour Representation" on page 56. 

7.1.1.2 JPEG 

JPEG as defined in ISO/IEC 10918-1 [21] using the JFIF [35] file exchange format. 

Only coding using sequential DCT-based mode or progressive DCT-based mode is required to be supported by 
implementations. 

Specifically, lossless and hierarchical modes need not be supported. 

7.1.1.3 PNG 
PNG is defined as in PNG [37]. 

See also 15.1, "PNG - restrictions" on page 230. 

7.1.1.4 GIF 

GIF is defined as in GIF 89a [17]. 

7.1.2 MPEG-2 l-Frames 

MPEG-2 I-Frames are defined as in ISO/IEC 13818-2 [24]. 
The payload of a file delivering an MPEG -2 I frame shall: 

• be a valid video_sequence() including a sequence_extension() 

• contain one I frame only, i.e. one picture_header(), one picture_coding_extension(), and one picture_data() 
encoded as an intra coded frame, with picture structure = "frame" 

That is the structure is: 

sequence_header () 

sequence_extension ( ) 

extension_and_user_data (0) 

optional group_of_pictures_header ( ) and extension_and_user_data (1) 

picture_header ( picture_coding_type = "I frame") 

picture_coding_extension ( picture_structure = "frame picture") 

extension_and_user_data (2 ) 

picture_data ( ) 

sequence_end_code ( ) 

7.1.3 MPEG-2 Video "drips" 

The drip feed mode consists of letting an application progressively feed the MPEG-2 video decoder with chunks of an 
MPEG-2 video stream. In this mode, it is only required for the decoder to handle I and P frames (i.e. not B frame). Each 
chunk shall contain one frame and a certain number of syntactic elements (as described in ISO/IEC 13818-2 [24]) such 
as sequence_header ( ) or group_of_picture_header ( ) . 
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Firstly, the content of each of the chunks of bytes fed to the decoder shall comply with the following syntax: 

optional { 

sequence_header () 
sequence_extension () 
extension_and_user_data (0) 
optional { 

group_of_pictures_header ( ) 

extension_and_user_data ( 1 ) 



picture_header ( picture_coding_type = "I frame" or "P frame") 
picture_coding_extension ( picture_structure = "frame picture") 
extension_and_user_data (2) 
picture_data () 
optional { 

sequence_end_code {) 
} 

In addition, the overall concatenation of chunks over time shall respect the authorized combinations of syntactic elements 
described in ISO/IEC 13818-2 [24] to build a legal MPEG-2 video stream. The following diagram, extracted from 
ISO/IEC 13818-2 [24], reflect the rules defined in that standard: 



►ISO/IEC 11172-2 



Picture 
Header 




* After a GOP the first picture shall be an I-picture 



Figure 10 



The following restrictions are applied to P-frames: 



• The P-frame shall contain no prediction information (i.e. no motion vector shall be present in macroblock 
elements). 

• The allowed macroblock_types for P-frames are: 

"Intra" (i.e. VLC code 0001 1) 

"Intra, Quant" (i.e. VLC code 0000 01) 

"No MC, Coded" (i.e. VLC code 01) 

"No MC, Coded, Quant" (i.e. VLC code 0000 1) 

NOTE: The standard semantics for P-frames allow macroblock_escape and macroblock_ 

address_increinent to signal skipped macroblocks. This allows P-frames to be very sparse, 
only carrying macroblocks positioned at certain locations on the screen. This contrasts with 
semantics for an I-frame where macroblocks are required to fill the fiill screen. 

If invalid content is fed to the MPEG-2 video decoder, the content is discarded and there are no guarantees when 
subsequent valid chunk of byte fed to the decoder will be displayed (unless the decoder is restarted). 

This mode requires the decoder to be in the "low delay" mode as defined in ISO/IEC 13818-2 [24]. 
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This mode can be used by connecting a org. dvb. media .DripFeedDataSource instance to a Player representing 
a MPEG-2 video decoder. See N, "(normative): Streamed Media API Extensions" on page 495. 

7.1.4 Monomedia format for audio clips 

The format for audio clips is MPEG-1 Audio (Layer 1 & 2) ES data as defined as in ISO/IEC 1 1 172-3 [22] and 
constrained in ETSI TR 101 154 [9]. 

Each "file" of audio content is a binary data file carrying Audio elementary stream data. Each "file" delivers an integer 
number of audio access units and the first byte of each file is the first byte of an audio access unit. The MPEG Audio data 
in all other respects conforms to the specifications provided in ETSI TR 101 154 [9]. 

Implementations decoding audio clips can assume that they have an approximately constant number of bytes per second. 
If this not true then the behaviour is implementation dependent. 

7.1.5 Monomedia format for text 

Java modified UTF-8 as defined in Java Language Spec [32] section 22.2.14 "writeUTF" is the coding of text in MHP 
NOTE: Based on ISO 10646-1 [18] but modified with respect to the encoding of the character code zero. 

7.1 .5.1 Built-in character set 

See E, "(normative): Character set" on page 349. 

7.2 Broadcast streaming formats 

7.2.1 Audio 

MPEG Audio with the restrictions and enhancements defined in ETSI TR 101 154 [9] 

7.2.2 Video 

Standard Definition 25 Hz MPEG Video with the restrictions and enhancements defined in ETSI TR 101 154 [9]. 

7.2.3 Subtitles 

The content formats supported for subtitles are: 

• DVB Subtitles 

• Teletext 

See 13.5, "Subtitles" on page 214. 

In the event that both DVB Subtitles and DVB Teletext are available then DVB Subtitles will take precedence (i.e. if a 
stream is flagged as having both DVB Subtitles and Teletext Subtitles then the DVB Subtitles will be displayed). 

Teletext Subtitles conform to the same display model, as DVB subtitles. 

Application control and detection of subtitles, whether they be DVB Subtitles or Teletext Subtitles, will be through JMF. 
The application will have no knowledge of the delivery /presentation protocol being used to provide subtitles. 

No APIs will be provided to access Teletext data packets and no timing model is provided for the decoding of Teletext 
subtitle. Text subtitles will be decoded as soon as the data becomes available. 

7.2.3.1 DVB Subtitles 

DVB Subtitles are defined as in ETSI EN 300 743 [13]. 
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7.2.3.2 



Teletext 



Transmission of the text is as defined in ETSI EN 300 472 [12]. The data fonnat is as defined in ETSI ETS 300 706 [61] 
but restricted to presentation level 1.5 or lower Signalling of the Teletext subtitle page will be via the Teletext descriptor 
as defined in ETSI EN 300 468 [4]. 

Within the MHP specification Teletext is only supported as an alternative content format for delivery of subtitles. The 
MHP specification does not address its possible use as a navigable content format. 

NOTE: Manufactures remain free to implement flill Teletext support based on regulatory requirement or 

market demand. Such support would be implemented outside of the MHP environment, by VBI re- 
insertion of the non-subtitle text or through a native Teletext Decoder. The user interface integration 
is then an issue for the manufacturer to resolve. 

It is envisaged that broadcasters will use MHP applications to deliver navigable text services 
providing a greater level of interactivity and enhanced graphics. 



7.3 



Resident fonts 



See section G.4, "Resident fonts and text rendering" on page 358. 
See also aimex D, "(normative): Text presentation" on page 330. 



7.4 



Downloadable Fonts 



PFRO (Portable Font Resource version 0) is defined as in DAVIC 1 .4. Ip9 [3] as the coding format for fonts. Receivers are 
only required to provide support for the outline version of the font. 

The charCode value in the PFR charRecord shall be the ISO 10646-1 [18] code for the glyph encoded using 
UCS-2. 

See also D.2.2, "Downloaded fonts" on page 330. 

For fonts in the PFR format, the font name shall be the font ID field in the font file. 

Each font in a PFR file can have auxiliary data in its physical font record. If present this auxiliary data shall adhere to the 
syntax as specified in table 1 below. It shall consist of a number of blocks terminated by a block of length and type 0. 

Table 1 : PFR auxiliary data 





No.of Bits 


Identifier 


auxDataFontRecordO { 






do { 






blockLength 


16 


uimsbf 


blockType 


16 


uimsbf 


switch (blockType) { 






case 2: 






for (i = 0; i < 10; i++) { 






reserved 

} 
ascent 


8 


uimsbf 


16 


tcimsbf 


descent 


16 


tcimsbf 


reserved 


32 


uimsbf 


externalLeadlng 


16 


tcimsbf 


for (1=0; 1 < (blockLength - 24); 1++) { 






reserved 

1 


8 


uimsbf 


break; 






default: 
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Table 1 : PFR auxiliary data 





No.of Bits 


Identifier 


for (i = 0; i < (blockLength - 4); i++) { 
reserved 

} 
break; 

} 
} while (blockLength > | | blockType != 0) 

} 


8 


uimsbf 



An auxiliary data font record consists of a number of blocks terminated by a block of length and type 0. 

blockLength: The total number of bytes in this block, including the blockLength and the blockType. 

blockType: A number that defines the type of data in the block. 0x0000-0x7fff are reserved, OxSOOO-Oxffff are user 
defined types. 

ascent: Represents the font ascent, which is the distance from the base line to the top of most alphanumeric characters. 

descent: Specifies the descent (units below the base line) of most alphanumeric characters. 

externalLeading: Specifies the amount of extra leading (space) that the application adds between rows. The designer 
may set this member to zero. 

MHP terminals shall ignore the contents of the reserved fields within block type 2 for the purposes of computing font 
metrics. MHP terminal behaviour for block types other than 2 is implementation dependent and these should not be used 
by MHP applications. 

7.5 Colour Representation 

7.5.1 Background (informative) 

The method of colour encoding is critical to how consistently the colours in an image can be reproduced across different 
systems. The description must be cast in a way which is independent of the mechanisms by which it will finally be 
reproduced for the viewer. 

The International Colour Consortium (ICC) has proposed a thorough solution to the precise communication of colour in 
open systems. However the ICC profile format is somewhat over-specified for the MHP. The ICC mechanism for 
ensuring that a colour is correctly mapped from an input to the output colour space is by attaching a profile for the input 
colour space to the image in question. This is appropriate for high end systems, especially those in the print media. 
However, a primarily CRT based home platform neither needs, nor has the processing power and available bandwidth, to 
handle an embedded profile mechanism. It would also require some sophistication on the part of the end consumer to set 
up properly. 

Fortunately by adopting a single default colour space that can be processed as an implicit ICC profile the advantages of 
the ICC approach are gained, and the system is later scalable to a full colour management system with a clear 
relationship to existing ICC colour management systems while minimizing software and support requirements in an 
MHP today 

A colour space is a model for representing colour numerically in terms of three or more coordinates or tristimulus values. 
An RGB colour space represents colours in terms of Red, Green and Blue coordinates. The MHP format shall use the 
specific RGB encoding for colour imagery, sRGB as defined in lEC 61966-2-1 [27]. This is suitable for a wide range of 
presentation environments including TV's and has become widely adopted in the computer environment and WWW. It is, 
for example, compatible with CCIR Recommendation ITU-R BT.709 [30] standard for colour encoding in HDTV. This 
format has the advantage of device independence without a great deal of additional overhead. 

For sRGB, the goal is to communicate the appearance of colours as displayed on a reference monitor in terms of 8-bit 
digital code values for each coordinate. sRGB colour values represent colour appearance with respect to a defined 
reference viewing environment. 
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For colour stimuli viewed in the reference viewing environment, sRGB values are defined by a series of simple 
mathematical operations from standard CIE colourimetric values. 

The sRGB format is a good match for 24 bit colour on most CRT's. In devices where a great deal of damage is done to the 
colour space it may not give consistent results. For example dithering to a 4-bit per primary colour map will violate the 
gamma assumptions. 

7.5.2 Specification 

All images transmitted shall be within the gamut encompassed by the sRGB colourspace. Where possible this should be 
coded so that the terminal does not have to translate. Where this is impractical the sRGB image may be transcoded into a 
different colourspace provided the gamut assumption is not violated (i.e. to be consistent with JFIF, JPEG images shall 
be sent in the region of the YC^Cb colourspace that overlaps with the sRGB gamut). 

NOTE: that the presentation of images using colours outside of the sRGB gamut shall be platform 
dependent. 

Images created in the MHP will be in the sRGB colourspace by default, although manufacturers are free to provide 
support for other colour spaces if they choose. All MHPs shall support transformations from sRGB to the colour spaces 
allowed by the MPEG-2 definition (e.g. BT 709 and BT 420) and vice versa, manufacturers may choose to support 
transformations to and from other colour spaces. 



7.5.2.1 



The sRGB Reference Viewing Environment 



The reference display conditions and viewing environment for sRGB are partly described in table 2. A reference viewing 
environment must be provided to allow for the unambiguous definition of colour, the sRGB reference viewing 
environment corresponds to conditions typical of indoor viewing of CRTs - further details can be found in the lEC 
61966-2-1 [27]. 

The sRGB reference conditions therefore provides a well defined reference compatible with ITU-R BT.709 [30]. 

Table 2 : sRGB reference Display conditions 



Condition 


sRGB 


Viewing flare 


1,0% 


Reference Background 


20% 


Display model Offset 


0,055 


Display Gun/Phosphor Gamma 


2,4 


Display white point 


X = 0,3127 y = 0,3290 (D65 Hunt, R.W.G. [52]) 


Ambient Lighting 


64 Ix 


Display Luminance level 


80 cd/m2 



7.5.2.2 



Colourimetric Definitions and Encodings 



sRGB tristimulus values can be computed as follows, firstly linear sRGB tristimulus are computed as linear combinations 
of the 1931 CIE XYZ (CIE 15 [1]) values usmg the following relationship: 



sRGB 



sRGB 



sRGB 



3,2410 -1,5374 -0,4986 
-0,9682 1,8760 -0,0416 
0,0556 -0,2040 -1,0570 



D65 



D65 



"D65 



In the encoding process, negative sRGB tristimulus values, and sRGB tristimulus values greater than 1,00 are not 
retained. The luminance dynamic range and colour gamut of sRGB is limited to the tristimulus values between 0,0 and 
1,0 by simple clipping. This gamut, however, is large enough to encompass most colours that can be displayed on CRT 
monitors. 
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For comparison, the CIE chromaticities for the red, green, and blue ITU-R BT.709 and ITU-R BT.470 reference 
primaries, and for CIE Standard lUuminant D65 (lEC 61966-2-1 [27]), are given in tables 3, 4. From these primaries the 
YC^Cj transmitted values are computed by similar relationships. 

Therefore ITU-R BT.709 YCi,Cj. colourspace and similar video colour spaces can be converted to sRGB and vice versa 
by way of CIE XYZ. Chromaticities for other video formats allowed in MPEG streams can be found in their respective 
standards. 



Table 3 : ITU-R BT.709 reference primaries and CIE standard illuminant 





Red 


Green 


Blue 


D65 


X 


0,6400 


0,3000 


0,1500 


0,3127 


y 


0,3300 


0,6000 


0,0600 


0,3290 


z 


0,0300 


0,1000 


0,7900 


0,3583 



Table 4 : TU-R BT.470-2 reference primaries and CIE standard illuminant 





Red 


Green 


Blue 


D65 


X 


0,6700 


0,2100 


0,1400 


0,3100 


y 


0,3300 


0,7100 


0,0800 


0,3160 


z 


0,0100 


0,0800 


0,7800 


0,3740 



The linear sRGB tristimulus values are next transformed to non linear sR'G'B' values. This process closely approximates 
the effect of a "gamma" curve of 2,2 with a slight offset. This makes sRGB consistent with legacy systems and images. 

if RsRGB > 0,00304 and G^rgb > 0,00304 and B^rgb > 0,00304 
then 

R',RGB = 1,055 * R,RGB ^(1,0/2,4) - 0,055 

G',RGB = 1,055 * GsRGB ^(1,0/2,4) - 0,055 

B'sRGB - 1,055 * B,RGB "(1,0/2,4) - 0,055 
else 

R'sRGB " 12,92 * RgRGB 

G'sRGB ^ 12,92 * GsRGB 

B'sRGB = 12,92 * BjRGB 

end if 

Finally, the non-linear sR'G'B' values are converted to digital code values. This conversion scales the sR'G'B' values by 
using the equation below where WDC represents the white digital count and KDC represents the black digital count. 

Rgbrt = ((WDC - KDC) * R' ,rgb) + KDC 

Ggbit - ((WDC - KDC) *G' ,rgb) + KDC 

Bgbit = ((WDC - KDC) * B' ,rgb) + KDC 

The current sRGB specification uses a black digital count of and a white digital count of 255 for 24-bit (8-bits/channel) 
encoding, and the MHP shall adopt the same convention. However, note that some digital video signals may use a black 
digital count of 16 and a white digital count of 235 in order to provide a larger encoded colour gamut. 
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Details of the reverse transformation from sRGB to CIE XYZ are given in lEC 61966-2-1 [27], mappings from ITU-R 
BT.709 and ITU-R BT.470 to CIE XYZ are given in ISO/IEC 13818-2 [24]. 



7.6 MIME Types 



Table 5 : File type identification 



MIME type 


Extension 
(note 1) 


Definition of content 


"image/jpeg" 


"Jpg" 


As defined in 7.1.1.2, "JPEG" on page 52. 


"image/png" 


".png" 


As defined in 7.1.1.3, "PNG" on page 52 possibly with a constrained 
profile as defined in 15.1, "PNG - restrictions" on page 230. 


"image/gif 


".gif 


As defined in 7.1.1.4, "GIF" on page 52. 


"image/mpeg" 


".mpg" 


As defined in 7.1.2, "MPEG-2 l-Frames" on page 52. 


"video/mpeg" 


".mpg" 


As defined in 7.2.2, "Video" on page 54. 


"video/dvb.mpeg.drip" 


".drip" 


As defined in 7.1 .3, "MPEG-2 Video "drips"" on page 52. 


"audio/mpeg" 


".mp2" 


As defined in 7.1.4, "Monomedia format for audio clips" on page 54 or 
as defined in 7.2.1, "Audio" on page 54. 


"texVdvb.utfS" 


".txt" 


As defined in 7.1 .5, "Monomedia format for text" on page 54. 


"image/dvb. subtitle" 


".sub" 


As defined in 7.2.3, "Subtitles" on page 54. 


"text/dvb.subtitle" 


"text/dvb.teletext" 


".tlx" 


As defined in 7.2.3.2, "Teletext" on page 55. 


"application/dvb.pfr" 


".pfr" 


As defined in 7.4, "Downloadable Fonts" on page 55. 


"application/dvbj" 


".class" 


A DVB-J class file. See 6.2.5.1, "DVB-J class files" on page 48. 


"multipart/dvb.service" 


".SVC" 


An MPEG Program (DVB Service) conforming to DVB norms. 


NOTE 1 : Future formats may use more characters in the extension 



7.6.1 



Rationale 



The MIME types are defined to reserve a name space for the possible future support of downloadable JMF players. 

The file name extensions shall be included in broadcasts to assist receivers identify the type of the content. For DVB-J 
applications, this is described in table 41, "Return types of URL.getContent()" on page 109). 

Not all MIME and filename extensions defined in the above table are actually used in this specification. For DVB-J, the 
APIs which consume media types are described in 15.2, "Minimum media formats supported by DVB-J APIs" on 
page 230. With MIME types whose corresponding media is not listed for a particular profile, access to that content type 
from files is not defined for that profile. 
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8 DVB-HTML 

8.1 Status of DVB HTML 

The DVB MHP specification provides the basic definitions needed for integration of DVB HTML applications into the 
MHP: 

• Definition of the term DVB HTML application and its lifecycle in 9.3. 1, "The DVB-HTML Application" on 

page 70. 

• How to signal a DVB HTML application in 10, "Application Signalling" on page 78. 

• Extensions on how to transport a DVB HTML application in 6.2.5.2, "DVB-HTML document files" on page 49. 

A definition of the content and application format elements from the HTML family is not in this release of the 
specification. Such a definition will be based on content formats defined by recognized bodies including W3C plus own 
developments. 
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9 Application model 

9.1 Broadcast MHP applications 

9.1.1 Basic lifecycle control 



The basic control of the Hfecycle of broadcast MHP applications is through the selection of broadcast services. Selection 
of a broadcast service can be initiated by the user of the MHP terminal using the Navigator as well as by MHP 
applications offering EPG functionality. Host Control tune requests from a CI module cause service selections. Host 
Control replace / clear_replace has an equivalent effect to using javax . tv . media . MediaSelectControl. 

The unit for the presentation and execution of content in the MHP specification is the service. A service in MHP 
represents a group of pieces of content which are intended to be presented together to the end-user.In this version of the 
specification, the service is the contents of a broadcast DVB service, including audio/video streams, data streams and all 
the service information, applications and application signalling that is being broadcast. 

Every service that gets presented by an MHP platform is presented within a service context. These form one of the 
foundations for the runtime environment and the execution model. A service context is an "environment" in which a 
service gets presented. It defines the boundaries of the service (letting the platform and applications identify which of the 
pieces of content that are being presented make up a given service). It also enables that service to be addressed and 
controlled as a single entity. 

• In a DVB-J application, a service context is represented by an instance of the ServiceContext class. Where 
multiple DVB-J applications are being presented in the same service context, the number of ServiceContext 
objects representing a service context is implementation dependant, but each application sees only one such 
instance. Changes made by one application to the ServiceContext object that it has are visible to the 
ServiceContext objects representing the same service context in other applications. DVB-J applications may 
obtain a reference to the service context within which they are executing through using the method 
getServiceContext (XletContext ) on the ServiceContextFactory class. 

The means by which the navigator of an MHP terminal supports selection of services is implementation dependent. 
However, where an MHP application is using the numeric keys of the remote control, the navigator shall not respond to 
the user pressing these keys by causing service selection. Hence the user pressing the numeric keys to enter his pincode 
does not cause service selection. 

A service context can present only one service at any one time. Selecting a service to be presented in a service context 
causes any previous service being presented in that service context to stop being presented. Any content part of the 
previous service which is not part of the new service shall stop being presented. MHP terminals may limit on the number 
of broadcast service contexts which can be presented simultaneously. 

• In a DVB-J application, selecting a service corresponds to calling the select ( ) method on such an instance. 

9.1.2 Starting applications 

When a broadcast service is selected, applications which are listed in the AIT of the service and identified as auto-start 
shall be launched as described in section 10.6, "Control of application life cycle" on page 85 without explicit intervention 
of the user. Applications which are started after the selection of a service will be controlled by signalling associated with 
that service. The MHP terminal shall monitor that signalling for changes made by the broadcaster. These changes may 
include the termination of particular applications as well as the addition of new auto-start applications. 

Applications which are not identified as auto-start in the AIT shall not be automatically launched by the MHP terminal, 
but require explicit launching. This explicit launching can be done by the resident Navigator on the MHP terminal or by 
an MHP application. For example, the user can launch such applications after they have been offered a choice of 
applications through some user interface. Since the resident navigator is not required to provide a mechanism for this 
explicit launching, broadcast services wishing to have applications started must provide an application which is identified 
as auto-start. 
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Where the currently selected service in a service context includes multiple MHP applications, any running applications 
may be able to launch other applications from that set. The launched applications shall be presented inside that same 
service context. 

• A DVB-J application is able to achieve this using the application listing and launching API. 

9. 1 .3 Support for execution of multiple simultaneous applications 

The set of applications that are signalled within a service can be presented and executed concurrently. 

MHP terminals shall be able to support applications from that set (using the same screen) at least as defined in the 
minimum platform capabilities section of this specification. MHP terminals are required to support execution of the set 
of such applications for each broadcast service which they permit to be presented simultaneously. 

Broadcasters should ensure that simultaneous running of the set of applications for a service is comprehensible to the 
user and does not yield perceptible interference problems. 

9.1.4 Stopping applications 

MHP applications may stop themselves voluntarily using the MHP APIs or may be stopped by the MHP terminal in a 
number of situations. Examples of situations where this shall be allowed include: 

9.1 .4.1 A new service being selected replacing a previously selected one 

When a new service is selected and replaces a previously selected one, applications from the former service shall only 
continue to execute where they are signalled in the new service. If an application is not signalled in that signalling then it 
will be stopped by the MHP terminal. Where an application is known to be bound to a single service, the broadcaster can 
identify that application as service bound using the service_bound_flag in the application descriptor Such applications 
shall be stopped as soon as possible by the MHP terminal and without needing the AIT for the new service to be 
available. This allows the autostart application(s) of the new service to be started earlier than would otherwise be the 
case. 

9. 1 .4.2 The stopping of an application by another application 

Subject to the security policy of an MHP terminal, one application may request to stop another application. In such a 
case, the resident Application Manager, after a successful security check, kills the application otherwise that application 
shall continue running, without interruption. 

9.1.4.3 Changes in the application signalling to request a particular application be 
stopped 

The broadcaster may request an MHP terminal to stop an application using the control codes in the AIT. The precise 
semantics of these are dependent on the application format. 

9. 1 .4.4 Stopping by the MHP terminal due to a shortage of resources 

Where an MHP terminal has insufficient resources (e.g. memory, CPU and resources managed by the resource 
management API) to continue the execution of one of the running applications, the MHP terminal is allowed to decide to 
stop an MHP application without user intervention. 

NOTE: The precise resources of an MHP terminal are implementation dependant. 

9. 1 .5 Persistence of Applications Across Service Boundaries 

Where a running application is signalled in both the new service and the former service, and is not signalled as service 
bound in the former service, it shall continue to run and shall not be restarted. In this case, the running application shall 
become controlled by the application signalling of the new service where it is signalled and not the signalling of the 
former service. Hence the MHP terminal shall monitor the AIT of the new service and shall stop responding to the AIT of 
the former service. 
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If the application is signalled as service bound in the former service then it is terminated in the normal way as the new 
service is selected. If it is signalled as auto-start in the new service it will restart with no volatile context from the 
previous instantiation. 

If an application survives a service selection operation, it will not automatically gain access to any new broadcast file 
system on the new service. It remains logically attached to any broadcast file systems it has already attached to, although 
it may be temporarily disconnected from the broadcast carousels feeding those file systems. The behaviour of the 
broadcast file system under these circumstances is defined in 6.2.5.3, "Loss of Carousel Behaviour" on page 49. 

If temporarily disconnected, the broadcast carousel shall be recormected upon selection of a service where the carousel is 
available. This includes, but is not exclusively, the original service the application ran in. To determine carousel 
availability, the MHP shall use the PMT information obtained for the "home" service of the carousel at the time of 
mounting, and the PMT of the currently selected service. 

9.1.6 Management of autostarting 

The receiver shall launch autostart applications under the following conditions: 

• the signalling indicates that the application can be supported by the receiver, as defined by the application profile 
& versioning information contained in the application descriptor, 

• only a single application with a given Application identification is allowed to run at any time, 

• the application is a newly introduced autostart application or has newly been given autostart status. 
So: 

• when a service is selected the receiver shall launch at most one instance of each autostart application that it can 
support, 

• if after service selection an autostart application that the receiver can support is introduced or a previously listed 
supportable application gains autostart status then the application shall be launched subject to normal resource 
limitations, etc. 

However, if an autostart application terminates itself, it shall not be restarted unless it again becomes a new autostart 
application. An application becomes a new autostart application in the following cases: 

• The receiver navigates away from the service and then selects a service where the application is autostart. 

• The application is removed from the AIT and then is re-introduced. 

• The autostart status of the application is reset then set again. 

NOTE 1 : In summary the autostart status of an application is in effect an edge trigger rather than level trigger 
signal. 

NOTE 2: These semantics for the autostart behaviour address "de-bouncing" the case where an autostart 

application terminates voluntarily. They do not address the case where the receiver terminates the 
application. 

In this case the platform may attempt to re-start the application however this is implementation 
dependent. 

NOTE 3: This specification does not describe in detail the timing required for the broadcast signalling to 
renew the autostart status of an application. 
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9.1.7 When tuning is not service selection! 

MHP applications may cause tuning to another transport stream by mechanisms other than service selection. Usage of 
these mechanisms does not constitute service selection and therefore no applications from the target transport stream or 
service shall be started either by the MHP terminal or by MHP applications. The MHP terminal shall continue 
monitoring the AIT of the logically selected service where this is available on the target transport stream. Where the AIT 
of the selected service is not available, the application shall continue executing as described in 10.4.4, "Visibility of AIT" 
on page 8 1 . The service being presented in the service context shall not be changed by an application using these 
mechanisms: 

• DVB-J tuning APIs 

9.1.8 DVB-J Applications and Service Selection 

DVB-J applications may select services using the service selection API. The service selection API includes a class 
ServiceContext to represent environments in which services may be presented. Calling the select method on a 
ServiceContext causes a new service to be presented in that context and any former service being presented in that 
context will be stopped. 

Where one MHP application uses the application listing and launching API to successfully start a second MHP 
application, the second MHP application shall be considered as executing inside the service context of the first MHP 
application. The number of ServiceContext objects representing a service context is implementation dependant, but 
each application sees only one such instance. Changes made by one application to the ServiceContext object that it 
has are visible to the ServiceContext objects representing the same service context in other applications. 

DVB-J applications started in response to a service selection operation are considered to be executing "inside" a service 
context. They may obtain a reference to the service context within which they are executing through using the method 

get ServiceContext (XletContext ) on javax . tv. service .selection . 
ServiceContextFactory. 

9.2 DVB-J Model 

9.2.1 Starting DVB-J Applications 

DVB-J applications may be started by any of the means defined for general MHP applications. The application listing 
and launching API defined in annex S, "(normative): Application Listing and Launching" on page 642 allows one MHP 
application to start another MHP application subject to security policy. The start ( ) method of the AppProxy 
interface will then cause the Application Manager to start the new MHP application subject to normal resource 
limitations. 

The Xlet interface is defined in the j avax . tv . xlet . Xlet interface Java TV [51]. DVB-J applications provide a 
class implementing this interface and reference that class in the DVB-J application location descriptor. In order to start a 
DVB-J application, the application manager shall call the constructor of this class, the initXlet ( ) and the 
startXlet ( ) methods of this interface. 

9.2.2 Stopping a DVB-J Application 

DVB-J applications may stop for any of the reasons listed for general MHP applications. An application shall be able to 
notify that it is stopped by finishing its execution and informing the Application Manager through the 
notifyDestroyed ( ) method on the javax . tv. xlet . XletContext interface. This interface also includes 
other methods to allow a DVB-J application to request or notify changes in its state. 

The application listing and launching API allows an application to indirectly control the lifecycle of another application 
subject to security policy. This control is indirect because an application cannot invoke an Xlet state method directly, but 
goes through this API. This ensures that the resident Application Manager can always keep track of all the application 
that are running. 
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When a DVB-J application is stopped by an MHP terminal, the destroyXlet method of the signalled Java class 
implementing the Xlet interface, i.e. the initial class of the application, shall be called by the application manager. In the 
case of the application being stopped due to a service selection operation, the stopping of the application shall be 
unconditional. This method call gives applications their last opportunity to save state before their execution stops. 
Applications which wish to survive the user of the MHP terminal zapping away from their service (e.g. during an 
advertising break) must save their state and reload that state when they are re-started if the user returns to that service 
later. 

9.2.3 DVB-J Application Lifecycle 

9.2.3.1 Introduction 

This section describes the Xlet lifecycle model for the DVB-J API. This describes the capabilities of the Xlet in each state 
and the methods by which the application manager influences the life cycle state. This section is not directly related to 
other aspects of a system, such as graphics or shared resource allocation/management. 

NOTE: The traditional Java platforms define a number of application models that have their own lifecycles 
associated with them. In general, they are designed to address specific issues on that platform. For 
instance, the Applet was designed to provide support for executable content in web pages. However, 
none of the existing application technology fiilly addresses the specific requirements of television 
receivers. The application lifecycle defined in this section is meant to be compatible with existing 
Java platforms and virtual machine technology. 

This section defines the lifecycle of an instance of a DVB-J application. The lifecycle of a DVB-J application and of a 
application instance are the same except that when an application instance is destroyed, the application is only transiently 
destroyed and then becomes not loaded. See org . dvb . application . AppProxy . NOT_LOADED in annex S, 
"(nonnative): Application Listing and Launching" on page 642. 

9.2.3.2 Lifecycle state machine for DVB-J application instances 

The Xlet state machine ensures that the behaviour of an Xlet is close to the behaviour that television viewers expect, 
specifically: 

• The perceived start-up latency of an Xlet can be very short. 

• It is possible to put an Xlet into a state where it is not providing its service. 

• It is possible to destroy an Xlet at any time. 

The figure 1 1 shows the state machine model for Xlets. The Xlet states are defined in more detail in table 6. 
The different influences that can cause an Xlet to change state include: 

• The application manager uses the Xlet API to signal these changes to the Xlet. 

Various factors may stimulate the application manager to act in this way, for example: 

• Broadcast signalling (e.g. a change in the state of the application_control_code parameter carried by the AIT 
(see 10.4, "Application Information Table" on page 80)). 

• User selection of an application in a host provided UI 
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• The Xlet itself "decides" to change state 

The apphcation uses theXletContext Object to communicate or request such changes to the apphcation 
manager. 

• Another Xlet acts via the application launching API (see 11.7.2, "Application discovery and launching APIs" on 
page 132). 
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Figure 11 : Xlet lifecycle state machine diagram 
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Table 6 : Valid lifecycle states of DVB-J application instances (Sheet 1 of 2) 



State Name 


Description 


Loaded 


The DVB-J application instance has been loaded and has not been initialized. 

The signalled Java class used to initiate a DVB-J application instance must implement the 
j avax . tv . xlet . Xlet interface. Otherwise, the class (and hence the application 
instance) may be ignored. An instance of the signalled Java class is created by the 
application manager e.g. using the Class, newlnstance method. Therefore a DVB-J 
application instance must have a public "default constructor". Otherwise, the class (and 
hence the application instance) shall immediately enter the Destroyed state. If the 
default constructor returns without throwing an uncaught exception, then the application 
instance is considered to be "Loaded", otherwise the application instance immediately 
enters the Destroyed state and is discarded. Once the appHcation instance has been 
successfully loaded and instantiated, the application manager can transition the 
application instance to the Paused state by invoking the initXlet method on the 
signalled class (implementing the Xlet interface). 

If the initXlet () method throws an XletStateChangeException then the 
application instance shall remain in the Loaded state. The only possible state transition 
for such an application instance is into the destroyed state. The application instance can 
request this itself or wait for the application manager to cause this transition. 

Notes: 

• Application initialisation is intended to occur in the initXlet method, rather 
than in the default constructor. 

• This state is entered only once per instance of an DVB-J application. 


Paused 


A Paused DVB-J application instance should minimize its usage of resources if it wants 
to maximize its probability of survival. This does not imply that it cannot be holding any 
resources, but in such a case, it would have a lower priority as concerns access to 
resources than it had when it was in the Active state. 

This state is entered: 

• From the Loaded state after the Xlet . initXlet ( ) method returns 
successfully when invoked by the application manager (the first time). Other 
invocations of this method do not cause the change of state. 

Note that the application manager shall only call initXlet ( ) once per instance 
of a DVB-J application. 

• From the Act ive state after the Xlet . pauseXlet ( ) method returns 
successfully when invoked by the application manager. Other invocations of this 
method do not cause the change of state. 

• From the Active state upon entering the XletContext . notifyPaused ( ) 
method. 
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Table 6 : Valid lifecycle states of DVB-J application instances (Sheet 2 of 2) 



State Name 


Description 


Active 


The DVB-J application instance is functioning normally and providing service. 

This state is entered: 

• From the Paused state after the Xlet . startXlet ( ) method returns 
successfully. 


Destroyed 


The DVB-J application instance has released all of its resources and terminated. 
This state is entered: 

• When the Xlet's destroyXlet method returns successfully. The 
destroyXlet ( ) method shall release all resources held and perform any 
necessary clean up so the Xlet may be garbage collected. 

• Upon entering the XletContext . notif yDestroyed ( ) method. The Xlet 
performs its clean up actions before calling the notifyDestroyed ( ) method. 

NOTE: This state is entered only once per instance of an DVB-J application 
instance. 



Every time a DVB-J application instance is started (i.e. the constructor of the object implementing Xlet is called), it shall 
logically run in its own new virtual machine instance. See 1 1 .2. 1, "Basic Considerations" on page 104. 

Only the DVB-J application can determine if it is able to provide the service for which it was designed. As such, in some 
respects an application manager cannot guarantee whether an DVB-J application can, or is, providing its service; and 
application manager can only indicate that the DVB-J application is able to do so. A typical sequence of DVB-J 
application execution is: 

Table 7 : Typical DVB-J application lifetime walk through 



Application Manager 


DVB-J application 


The application manager creates a new 
instance of an Xlet. 


The Xlet's default (no argument) 
constructor is called, it is in the Loaded 
state. 


The application manager creates the 
necessary context object for the DVB-J 
application to run, and initializes the Xlet. 


The DVB-J application uses the context 
object to initialize itself. It is now in the 
Paused State. 


The application manager has decided that 
it is an appropriate time for the DVB-J 
application to perform its service, so it 
signals it to enter the Active state. 


The DVB-J application acquires any 
resources it needs and begins to perform 
its service. 


The application manager no longer needs 
the DVB-J application to perform its 
service, so it signals the DVB-J application 
to stop performing its service. 


The DVB-J application stops performing its 
service and might choose to release some 
resources it currently holds. 


The application manager has determined 
that the DVB-J application is no longer 
needed, or perhaps needs to make room 
for a higher priority application in memory, 
so it signals the DVB-J application that it is 
a candidate to be destroyed. 


If it has been designed to do so, the DVB-J 
application saves state or user preferences 
and performs clean up. 



9.2.4 Xlet API 

The Xlet API provides MHP application developers with an API that provides life cycle signalling. The Xlet API uses the 
callback approach to signal state changes. 

This API is specified in section 11.7.1, "APIs to support DVB-J application lifecycle" on page 131. 
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9.2.4.1 Xlet State Change Semantics 

An Xlet's state can change either by having one of the methods on its Xlet Interface called, or by making an internal state 
transition and notifying the application manager via the XletContext Object. The semantics of when that state 
change actually happens are important: 

• Calls to Xlet : this interface indicates a successful state change only when the call successfully returns. 

• Calls to XletContext: the notifyDestroyed and notifyPaused ( ) methods indicate a state change 
on entry. The resumeRequest ( ) method indicates no state change, instead only a request to change state. 

If a method on the Xlet interface throws an XletStateChangeException, the Xlet shall remain in the state it was 
in immediately prior to the call of the method throwing the exception unless otherwise specified. In this specification, the 
only exception to this rule is the destroyXlet method when the unconditional flag is true where throwing the 
XletStateChangeException is specified to have no effect. For the case of initXlet which may only be called 
once, the application manager may choose to transition the Xlet to the destroyed state (without calling destroyXlet) 
some implementation specific time later. 

9.2.4.2 Xlet state change requests 

The following table defines the previous states in which calls to the methods on XletContext relating to state 
management are valid; 

NOTE: These methods are called after the Xlet has changed its state. 

Table 8 : States for valid state management calls 



Call 


State 


notifyDestroyed 


all states 


notifyPaused 


active only 


resumeRequest 


paused only 



Calls to these methods when an Xlet is in any other state shall have no effect. 

9.2.5 Multiple application environment support 

The DVB-J platform allows for the simultaneous execution of several DVB-J applications. 

Allowing several DVB-J applications to run simultaneously implies that some rules be defined for these DVB-J 
applications to share the resources of the MHP, and in particular for them to share the Input Focus and the Output Focus. 

9.2.5.1 Control of DVB-J applications by other DVB-J applications 

The MHP provides support for control of the lifetime of a DVB-J application by another DVB-J application. This feature 
enables broadcasters to write their own "Launcher applications" that take care of the presentation to the user of the 
availability of DVB-J applications, and that enables eventually the user to launch DVB-J applications. Note that the 
actual control of the lifetime of an DVB-J applications is done by the Application Manager only. The MHP only provides 
APIs that enable DVB-J applications to ask the Application Manager to start, stop, pause and resume DVB-J 
applications. 

See 1 1 .7.2, "Application discovery and launching APIs" on page 132. 

9.2.5.2 Input Focus management 

The input focus is defined as follows: 

• the application that has input focus is in principle able to receive user-input events. 

• other applications not having the input focus can request to receive a subset of user-input events via a dedicated 
API. See "org.dvb.event" on page 111. 
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9.2.5.3 Other resources management 

The APIs defined in this specification provide support for resource allocation/revocation and resource revocation 
notification. The semantics of the APIs, however does not define under which circumstances an access to a resource is 
granted or revoked. While it is well understood that in most cases, it is up to the MHP implementation to define its own 
policy in terms of resource management, this section defines the basic rules that an MHP implementation has to follow. 

The MHP specification describes a multi-application environment. Hence several applications may be competing for 
access to the same atomic resource. The resource notification API described in section 1 1.7.5 on page 136 provides a 
common way for applications to negotiate access to scarce atomic resources when such competition happens. This API 
allows for the MHP terminal to inform the application that currently holds the resource that another application wants to 
access this resource. It also provides a means for the owner of the resource and to the requester of the resource to 
communicate by private means. This private communication is reflected by the request_data object that the requester may 
pass to the owner. The semantics of this object is private and has to be known by both applications. 

Some existing and general purposes Java APIs that were developed before the MHP work was started do not use this 
general resource sharing mechanism. Hence access to resources addressed by these APIs are not subject to negotiation. 
For example, when an application holds a JMF player, if another application was to create a JMF player for the same 
content-type, the MHP has to decide by itself whether it withdraws the resource underlying the JMF player from the 
current owner and grants it to the requester. 

It is also possible for applications to use the inter-application communication API to establish private communication 
channels enabling them to negotiate access to resources. 

9.2.5.4 VM implementation 

Where there are multiple DVB-J applications being executed as part of the same service, MHP terminals are allowed 
implement these in a single actual virtual machine instance. Regardless this shall conform to 1 1.2.1, "Basic 
Considerations" on page 104. 

9.3 DVB-HTML Model 

9.3.1 The DVB-HTML Application 

9.3.1.1 DVB-HTML Application 

A DVB-HTML application is defined as a set of documents selected from the DVB-HTML family of elements and 
content formats as defined in the specification. The extent of the set is described by the application boundary. 

9.3.1.2 User agent 

A user agent is an application that interprets a content format (in this case DVB-HTML documents). 
Note This could be implemented as a plug-in. 

9.3.1.3 DVB-HTML Actor 

A DVB-HTML actor is defined as the locus of activity or process involved in running the specific set of DVB-HTML 
documents for some DVB-HTML application, plus any instantiated context for that data. The actor runs inside a user 
agent (native, plug-in or downloaded). The nature of the process is not defined explicitly as it depends on the nature of 
the user agent itself. More than one such locus of activity may be present in any given user agent. 
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There is a single DVB-HTML Actor for each running DVB-HTML Application, each DVB-HTML Application can 
consist of multiple documents several of which could be simultaneously displayed. 
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9.3.1.4 



Figure 12 : Relationships between actors and applications 

Application boundary 



The application boundary defines the extent of a DVB-HTML Application. Any content documents outside of the 
application boundary are considered to not be part of the DVB-HTML Application and shall be unavailable to the 
referencing DVB-HTML application. An MHP terminal may contain an implementation specific mechanism to allow the 
end-user to decide to explicitly access the resource outside the boundary but this shall not be in the context of the original 
DVB-HTML application. This namespace can be used by a broadcaster to easily control the perimeter of user navigation 
and by an MHP implementation to more efficiently pre-fetch applications. 

The logical extent of a DVB-HTML application could potentially be quite large, and for various reasons might not all be 
on the MHP terminal at one time. Part of it might be broadcast, part of it might be on local storage, part of it might be on 
the world wide web - some of it may even be generated on demand. For this reason the compact format of the regular 
expression is used to define the extent. The set of documents making up a DVB-HTML application is defined by a regular 
expression over the locator language, broadly a locator consists of a text string in the following form from 
IETF RFC 2396 [41] and acts as the glue which holds the application together. 

scheme : //host/dirl/dirn/f ile#subref 

A regular expression is the definition of a set by a pattern which can test whether a given string is or is not a member of 
the set, for example the regular expression: 

https?://www\ . (dvbl etsi) \ .org/ [a-zO-9/] +\.html? 

Matches the logical locator of any file on both www.dvb.org or www.etsi.org, either reached by http or https, if and only 
if it is a DVB-HTML file (its name ends in ".htm" or ".html"), and its pathname contains only alphanumeric characters. 
Quite terse definitions can match a large set of files [see for example Compilers [C]]. 



9.3.1.4.1 



Regular Expression Syntax 



A regular expression (RE) specifies a set of character strings to match against. A member of this set of strings is said to 
be matched by the regular expression. 

In order for a locator to match a boundary regular expression the whole locator must be matched by the whole regular 
expression; any parameters (characters including and after the first "?" or "#" in the locator) are not considered as part of 
the locator for purposes of boundary matching. 

The form of regular expression used for defining application boundaries is defined as a POSIX Extended Regular 
Expression from POSIX [59] section 2.8.4.: 

Relative locators in the DVB-HTML application are expanded to a fiiU URI as defined in IETF RFC 2396 [41], (the 
default base URI being that carried in the application location descriptor) before being matched. 

A pattern may be broken into sub patterns in a set of application boundary descriptors (see signalling). The full pattern is 
formed from the OR of all the sub patterns. Each application boundary descriptor may be associated with a label (see 10. 
10.3, "DVB-HTML application boundary descriptor" on page 101). This label can be used for pre fetching in a transport 
specific manner, for example in an object carousel it defines that all modules matching the label should be preloaded. 
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For example: an application consists of an entry web page /phaseO/index.html, and is factored into three sub sections, 
each of which has an associated stylesheet and image directory. 



labelA 
labelB 
labelC 



(/phaseO/ . +\ . html | /phaseO/imagesl/ . +\ .png | /phaseO/scriptsl/ . +\ . js) 
(/phasel/ . +\ . html | /phasel/images/ . +\ .png | /phasel/scripts/ . +\ . js) 
(/phase2/ . +\ . html | /phase2/images/ . +\ .png | /phase2/scripts/ . +\ . js) 



The entry point locator signalled for this application matches the first regular expression, this allows the pre-fetch 
mechanism to load the modules labelled with labelA (which the broadcaster arranges to contain the contents of directory 
phaseO), Once the user agent is running, it can use this information to detect which if any links from the current page 
might transition to a new phase and therefore require more pre-fetching. 

9.3.2 DVB-HTML Application Lifecycle 

9.3.2.1 Introduction 

There are three key parts of the DVB-HTML application lifecycle model: 

a) How applications are signalled as available to the MHP, and for auto start and prefetch applications how the start 
time is synchronized with any associated media stream. 

b) How and when the application manager or other launcher application makes the presence of an non auto-start 
application known to the user and provides it with a trigger. This is covered by the application discovery and 
launching mechanisms. 

c) How a broadcaster controls an actor after it has started. 

9.3.2.2 Signalling 

The DVB-HTML Application is signalled as described in chapter 10, "Application Signalling" on page 78. 

The application manager can be requested to start a DVB-HTML application either because it is signalled as auto start, or 
through the application launching APL 

On receiving the request that a DVB-HTML application is to be started (i.e. an AUTOSTART or PREFETCH appears in 
the AIT or it is user instantiated), and there is no application with the same applicationID already instantiated, the 
application manager should attempt to find a suitable user agent. It can also at this point begin pre-fetching material. 

If the application manager is unable to instantiate a user agent either through lack of resources, or no suitable user agent 
being available then any pre-fetching can be aborted, and any trigger signal can be ignored. 

It is platform dependant at what time a DVB-HTML autostart application starts. For a pre-fetched DVB-HTML 
application a trigger is required which carries the time at which the application should start providing service. 

The DVB-HTML actor can be in one of 5 DVB-HTML Application states. 

• Loading 

• Active 

• Paused 

• Destroyed 

• Killed 

Each of these states has a precise meaning outlined in the following sections. The transitions between states are made as 
a result of, for example: 

• A trigger, such as a request to go to a new document, 

• A trigger such as the DVB-HTML application making an explicit request to change state, 

• A change in the external environment i.e. the application_control_code in the AIT changes. 
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Since a user agent may be performing as several actors, it can be in several of these states at one time, each actor however 
will be labelled with a unique application ID. 

A DVB-HTML application proceeds by moving between documents, while the documents remain within the 
DVB-HTML application boundary the DVB-HTML application continues to run normally. 

Links within an DVB-HTML application normally replace the existing document, but attributes may be present on a link 
which cause both the new and old document to be visible at the same time. 



9.3.2.3 



Lifecycle control 



The state model for the DVB-HTML application lifecycle control model described in this section reflects the signalling 
(see 10.6, "Control of application life cycle" on page 85) and is an abstract view of how a DVB-HTML application 
operates, and considers the kinds of resources that a user agent would need in order to function properly: resources 
concerned with output (rendering), input (event catching) and connection (the availability of the content). 

The abstract model however is mostly illustrative and does not imply any resource management strategy nor is it intended 
to overly constrain the implementation of a user agent; 



9.3.2.3.1 State diagram 

The following transition diagram summarizes the states and the transitions between them. 



Loading 



Active 




Killed 



Destroyed 



Figure 13 : DVB-HTML application life cycle state diagram 

9.3.3 The State Model 

The entry state of the state machine. Loading, is characterized by access to the content resources and signalling resources 
but does not have or require input and output resources. This implies the actor can prefetch content and receive triggering 
events for transition to the Active state, but will not be presented to the viewer. 

On entry into the Active state the actor would be assumed to have full access to the content of the current document and 
all resources of the MHP, subject to resource management and security issues. 

The paused state is a reduced operational state. If the application manager or the user agent needs resources for other 
purposes, an actor may be moved to the paused state, when in this state it may no longer have full (or even any) access to 
resources. When the actor is reactivated it returns to its previous state. 

The destroyed state can be characterized as loss of the content resource. The actor may still be able to run the 
DVB-HTML application due to caching or other mechanisms but must be prepared for loading of some or all of the 
documents from within the DVB-HTML application to fail. It is implementation dependent how such failure is handled. 
This is a way for the broadcaster to signal to the MHP that it is on it's own. 
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The killed state is characterized by the loss of all resources, and is the signal for actions concerned with cleanup of the 
actor. The MHP reclaims whatever resources it deems necessary. It is implementation dependent whether cached material 
is disposed of. 

If the AIT signal is KILL, an actor is forcibly terminated (and all resources associated with it reclaimed) regardless of 
state. 

An actor shall not stop running itself or a DVB-HTML application without transitioning the DVB-HTML application 
into the killed state 

9.3.3.1 Loading 

9.3.3.1.1 Name 

Loading 

9.3.3.1.2 Entry actions 

Instantiation of an actor. 

9.3.3.1.3 Activities 

Waiting for documents to be available and loading documents without rendering them. 

9.3.3.1.4 Resources 
Content, signalling. Output 

9.3.3.1.5 Transitions 

Active, preconditions: 

• enough data is available to present something sensible. 
Killed, preconditions: 

• If the DVB-HTML application is signalled as KILL, 
Destroyed, preconditions: 

• If the DVB-HTML application is signalled as DESTROY, 

9.3.3.1.6 Comment 

This is the entry state of the state machine This state is entered only once in the lifetime of the DVB-HTML actor. Any 
start-up phase of a user agent can also be considered as part of this state. When an actor is in this state it is not rendering 
anything. This state should not be confused with any prefetching of modules which may be carried out by the MHP prior 
to application launch. 



9.3.3.2 


Active 


9.3.3.2.1 


Name 


Active 
9.3.3.2.2 


Activities 



Gathering and parsing current document and related resources., rendering document. Maintaining rendered documents, 
receptive to events, waiting for triggering event to show loaded documents. 

9.3.3.2.3 Entry actions 

If application is signalled as pre-fetch wait for trigger before displaying anything. 
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9.3.3.2.4 Resources 

Content, signalling, output, input. 

9.3.3.2.5 Transitions 
Pause. 

• If the user agent or application manager puts the DVB-HTML application in PAUSE. 
Destroyed. 

• If the DVB-HTML application is signalled as DESTROY. 
Killed. 

• If the DVB-HTML application is signalled as KILL 

9.3.3.2.6 Comment 

This state is the steady state. 

In this state it is user agent specific as to whether a partially loaded document is displayed, or deals with input triggers. 

If a transition is made to a new document within the application, the actor remains in this state. 

If a related resource document of the main document changes, then the resource may be reloaded, causing the 
DVB-HTML actor to receive appropriate DOM events, however the DVB-HTML actor is not considered to change state. 
Similarly the DVB-HTML actor may gain and lose the focus while in this state, receiving the appropriate DOM events - 
it may receive fewer input events when it does not have the focus. 

If the AIT no longer refers to the DVB-HTML application no special action is taken for DVB-HTML actors that are in 
the Active state. 

9.3.3.3 Paused 

9.3.3.3.1 Name 

Paused 

9.3.3.3.2 Activities 

DVB-HTML actor should minimise its use of resources. 

9.3.3.3.3 Resources 

Application specific. 

9.3.3.3.4 Transitions 
Active. 

• If the DVB-HTML application is resumed. 
Destroyed. 

• If the DVB-HTML application is signalled as DESTROY. 
Killed. 

• If the DVB-HTML application is signalled as KILL 
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9.3.3.3.5 Comment 

The semantics of this state are both user agent and DVB-HTML application specific. When the DVB-HTML application 
returns from the "Pause" state, the environment might have changed (loss of resources or network connections) and some 
events may not have been reported. 

9.3.3.4 Destroyed 

9.3.3.4.1 Name 
Destroyed 

9.3.3.4.2 Activities 

Loading documents. Rendering documents. Consuming events. Interact with the user. 

9.3.3.4.3 Resources 

input and output. 

9.3.3.4.4 Transitions: 

Killed. 

• {If the DVB-HTML application is signalled as KILL} OR {local event forces the actor to terminate, possibly 
through application manager} 

9.3.3.4.5 Comment 

This state indicates the MHP may no longer be able to access the content resources required to run the DVB-HTML 
application. It is DVB-HTML application and user agent specific as to whether the actor continues to run, and if it does 
how the user should be informed if any link is no longer available because the content it refers to is no longer available, 
or a cached copy has expired. The DVB-HTML actor may continue to execute in the destroyed state until the user 
actively dismisses it. 



9.3.3.5 


Killed 


9.3.3.5.1 


Name 


Killed 
9.3.3.5.2 


Entry : 



Release of resources. 

9.3.3.5.3 Activities 

Termination of the DVB-HTML application. 

9.3.3.5.4 Resources 



9.3.3.5.5 


Transitions 


none 
9.3.3.5.6 


Comment 



After the activities in this state are finished, the application is no longer running. This state is the exit state of the state 
machine. 
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9.4 Inter application resource management 

This is implementation dependent except as detailed below. Where there is a resource conflict between two applications 
signalled as part of the same service and running in the same service context, this shall be resolved using the priority 
signalled in the application_priority field in the application descriptor for each application. When comparing two 
applications, the one with the higher application_priority value shall be considered the more important to preserve. 

• Where there is a resource conflict between two applications signalled as part of the same service and running in 
the same service context, this shall be resolved using the priority signalled in the application_priority field in the 
application descriptor for each application or the external application authorisation descriptor depending on which 
descriptor the application is currently signalled by. 

• Unless stated otherwise, only the application which owns a resource has the right to modify the state / settings / 
configuration of that resource. If a resident application (e.g. the MHP navigator) makes changes to the state / 
settings / configuration of a resource, the MHP terminal shall inform the MHP application which formerly owned 
the resource that the MHP application has lost ownership of the resource. 

NOTE: The only exception to this rule is where all applications running inside a service context together 
own the service component handlers of that service context and not any single one of them. See 1 1 . 
6.2, "Service Selection API" on page 128. 
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10 Application Signalling 
10.1 Introduction 

This section covers the following topics: 

• how the receiver identifies the applications associated with a service and finds the locations from which to retrieve 
them 

• the signalling that enables the broadcast to manage the lifecycles of applications 

• how the receiver can identify the sources of broadcast data required by the applications of a service 

Much of the signalling is generic. For example, the Application descriptor is independent of the application 
representation. Other signalling is specific to the application representation or transport protocol (such as the DVB-J 
application descriptor and the IP signalling descriptor). 

10.1.1 Summary of common signalling 

The minimum signalling requirements for any MHP applications are summarised as follows: 

• PMT with Application Signalling Descriptor to identify the service component carrying the Application 
Information Table. 

• Application Information Table with the following information in its common descriptor loop: 

- Transport protocol descriptor (all applications descriptions shall be within the scope of at least one Transport 
protocol descriptor. These can be placed in either or both of the descriptor loops) 

• Application Information Table with the following information in its application information descriptor loop: 

- Application descriptor 

- Application name descriptor 

10.1.2 Summary of additional signalling for DVB-J applications 

The minimum additional signalling required for DVB-J applications are summarised as follows: 

• Application Information Table with the following information in its application information descriptor loop: 

- DVB-J application descriptor 

- DVB-J application location descriptor 

10.1.3 Summary of additional signalling for DVB-HTML applications 

The minimum additional signalling required for DVB-HTML applications are summarised as follows: 

• Application Information Table with the following information in its application information descriptor loop: 

- DVB-HTML application descriptor 

- DVB-HTML application location descriptor 

10.1.4 Summary of additional signalling for applications carried via OC 

In either the "common" (first) descriptor loop or the "application" (inner) descriptors loop: 

• Transport protocol descriptor, with the selector bytes containing the OC specific information as defined in table 
28 
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10.1.5 Summary of additional signalling for applications carried via IP 

Application Information Table with the following information in its common descriptor loop: 

• IP signalling descriptor 

In either the "common" (first) descriptor loop or the "application" (inner) descriptors loop: 

• Transport protocol descriptor, with the selector bytes containing the IP specific information as defined in table 29. 

10.1.6 How to add a new scheme (informative) 

The signalling scheme is intended to be extensible with regard to the application representations and transport protocols 
that are supported. The areas that need to be addressed when doing this are summarised below. 

To add further transport protocols: 

• Extend table 27, "Semantic of selector bytes" on page 93 

• Possibly define further specialist descriptors such as the IP signalling descriptor 
To add further application representations: 

• Define further specialist descriptors such as the 10.9, "DVB-J specific descriptors" on page 98 

• Define the application type specific life cycle control codes in 10.6, "Control of application life cycle" on page 85. 
Where constant values are registered by this specification extend the table 39, "Registry of constant values" on page 102. 

10.1.7 Service information 

See 10.12, "Service Information" on page 103. 

10.2 Program Specific Information 

The elementary stream (inner) loop of the PMT for a DVB service supporting one or more MHP applications must 
reference streams for the following: 

• location of the stream transporting the Application Information Table 

• location of the stream(s) transporting the application code and data 

10.2.1 Application signalling stream 

The elementary stream information for the PMT entry describing the elementary stream carrying the Application 
Information Table has the following characteristics: 

• The stream_type is set to 0x05 (ITU-T Rec. H.222.0 | ISO/IEC 13818-lprivate sections). 

• An Application Signalling Descriptor 

There may be more than one elementary stream carrying application signalling information for a service. 

10.2.2 Data broadcast streams 

The minimum signalling in the PMT associated with data broadcast components is the value of the PMT stream_type 
field required by the DVB data broadcasting specification (ETSI EN 301 192 [5]) for the transport protocol. The full 
details of the data broadcast protocol, the location of its "principal" component etc. are provided in the AIT (see 10.4, 
"Application Information Table" on page 80). 

Optionally the PMT may include Data broadcast id descriptors. 
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NOTE: Inclusion of Data broadcast id descriptors enables receivers to start mounting the file system that 
delivers applications concurrently with acquiring the AIT that identifies which applications are of 
interest. Enabling this concurrent operation may allow receivers to accelerate their activation of an 
interactive apphcation. See B.2.10, "Mounting an Object Carousel" on page 320. 

The Data broadcast id descriptor identifies the "principal" component of the data broadcast. The detailed semantics of 
this optional signalling reflects the transport protocol. For example, in the case of a DVB Object Carousel it identifies the 
component carrying the DSL 

There may also be certain protocol specific descriptors in the PMT. For example, the Object Carousel requires the 
inclusion of the carousel_id_descriptor (see B.2.10, "Mounting an Object Carousel" on page 320). 

In its minimum form (with no selector information) a Data broadcast id descriptor just identifies the "principal" 
component. This optionally may be extended with selector information that identifies the application types of the 
autostart applications delivered by that data broadcast. See 10.7.2, "Data broadcast id descriptor" on page 87. 

10.3 Notation 

10.3.1 reserved 

The term "reserved" when used in the clause defining the coded bit stream, indicates that the value may be used in the 
future for ISO defined extensions. Unless otherwise specified within the present chapter all "reserved" bits shall be set to 

M 1 II 

10.3.2 reserved_future_use 

The term "reserved_future_use", when used in the clause defining the coded bit stream, indicates that the value may be 
used in the future for ETSI defined extensions. Unless otherwise specified within the present chapter all "reserved_ 
future use" bits shall be set to "1". 



10.4 Application Information Table 



The Application Information Table (AIT) provides full information on the data broadcast, the required activation state of 
applications carried by it etc. 

Data in the AIT allows the broadcaster to request that the receiver change the activation state of an application. 

10.4.1 Data errors 

AITs which contain errors shall be processed as follows:- 

• An error in a descriptor shall result in that descriptor being silently discarded. Processing of that descriptor loop 
shall continue with the next descriptor (if any). The scope of error detection of a descriptor should be limited to 
the application information section in which it is carried. 

• An error in an application loop outside a descriptor shall result in that entry in the application loop being silently 
discarded. Processing of that application loop shall continue with the next entry (if any). 

NOTE: The consequence of the above is that an error in a mandatory descriptor which results in that 
descriptor being silently ignored may then result in a application loop which is missing such a 
mandatory descriptor. Hence that application loop shall also be silently ignored. 

• An error in an application information section outside of an application loop shall result in that entire application 
information section being silently discarded. Processing of the AIT shall continue with the next application 
information section (if any). 

10.4.2 AIT transmission and monitoring 

MHP terminals shall monitor the PMT for changes in the number of AIT elementary streams present. Changes shall be 
detected within 1 second. 
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The minimum repetition rate for each AIT subtable is 10 seconds. The AIT shall be carried in an elementary stream 
which is not scrambled. 

Provided that AITs for the selected service are delivered on 3 or fewer elementary streams then the maximum time 
interval between the moment the AIT is updated and the moment the new version is detected by the MHP shall be no 
more than 30 seconds. 

Note If broadcasts use more than 3 elementary streams to deliver AITs then receiver response time may 

degrade in an unpredictable way. 

The MHP terminal is only required to monitor AIT sections for application types that it can decode. 

The set of application types listed in the application database reflects the set of AIT sections being monitored. So, this 
may be a subset of the application types being broadcast in the case that the broadcast carries a superset of the terminal's 
capabilities. 

10.4.3 Optimised AIT signalling 

The optional AIT_version_number carried by the Application Signalling Descriptor allows a possible optimisation of 
receiver burden as it allows receivers to acquire the AIT only after they see changes in the AIT version advertised in the 
PMT. 

See 10.7.1, "Application Signalling Descriptor" on page 86. 

10.4.4 Visibility of AIT 

If an application tunes away from a transport stream where its signalling is carried without selecting a new service, it will 
continue running although the AIT is not visible. 

In MHP terminals with multiple network interfaces, if the AIT of the selected service is visible via any of them, then the 
AIT signalling is used as normal. 

1 0.4.5 Definition of sub-table for the AIT 

All sections on the same PID with the AIT table_id and the same value of application_type are members of the same sub- 
table. 

10.4.6 Syntax of the AIT 

The Application Information Section describes applications and their associated information. Each Application 
Information Section includes one "common" descriptor loop at the top level for descriptors that are shared between 
applications of that sub table and a loop of applications. Each application in the application loop has an "application" 
descriptor loop containing the descriptors associated with that application. 

Like DVB SI tables, the scope of common loop descriptors is the sub-table. So, any descriptors present in the common 
descriptor loop apply to all sections of the sub-table. Typically, common descriptors would normally only be present in 
section of a sub-table, unless there was not enough space. 

Like other DVB SI tables, any strings contained in these tables shall not have null terminations. 
Table 9 : Application Information Section syntax (Sheet 1 of 2) 





No.of Bits 


Identifier 


application_inf ormation_section ( ) ( 






table_id 


8 


uimsbf 


section_sYntax_indicator 


1 


bslbf 


reserved_f uture_use 


1 


bslbf 


reserved 


2 


bslbf 


section_length 


12 


uimsbf 


test_application_f lag 


1 


bslbf 


application_type 


15 


uimsbf 


reserved 


2 


bslbf 
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Table 9 : Application Information Section syntax (Sheet 2 of 2) 





No.of Bits 


Identifier 








version_number 


5 


uimsbf 


current_next_inclicator 


1 


bslbf 


section_number 


8 


uimsbf 


last_section_number 


8 


uimsbf 


reserved_f uture_use 


4 


bslbf 


cominon_descriptors_length 


12 


uimsbf 


for (i=0; i<N; i++) { 






descriptor ( ) 






reserved_future_use 


4 


bslbf 


application_loop_length 


12 


uimsbf 


for (i=0;i<N;i++) { 






application_identif ier ( ) 






application_control_code 


8 


uimsbf 


reserved_f uture_use 


4 


bslbf 


application„descriptors_loop_length 


12 


uimsbf 


for ( j=0; j<N; j++) { 






descriptor ( ) 
} 






} 

CRC_32 
} 


32 


rpchof 



table_id: This 8 bit integer with value 0x74 identifies this table. 

section_syntax_indicator: The section_syntax_indicator is a 1-bit field which shall be set to "1". 

section_length: This is a 12-bit field, the first two bits of which shall be '00'. The remaining 10 bits specify the number 
of bytes of the section starting immediately following the section_length field, and including the CRC_32. The value in 
this field shall not exceed 1021 (0x3 FD). 

test_application_flag: This 1-bit field when set indicates an application which is transmitted for the purposes of 
receiver testing and which shall not be started or listed in any API or displayed in any user interface by MHP receivers 
under normal operational conditions. The means (if any) by which an MHP receiver is put into a mode where 
applications signalled with this bit set are treated as if this field is set to zero is implementation dependent but should not 
be one which typical end-users might discover on their own. 

application_type: This is a 15-bit field which identifies the type of the apphcations described in this AIT sub_table. 
See table 10. 

Table 10 : Application types 



application_type 


description 


0x0000 


reserved_future_use 


0x0001 


DVB-J application 


0x0002 


DVB-HTML application 


0x0003... 0x7FFF 


subject to registration witii DVB 



version_number: This 5-bit field is the version number of the sub_table. The version_number shall be incremented by 
1 when a change in the information carried within the sub_table occurs. When it reaches value "31", it wraps around to 
"0". 

current next indicator: This 1-bit indicator shall be set to "1". 
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section_number: This 8-bit field gives the number of the section. The section_number of the first section in the sub_ 
table shall be "0x00". The section_number shall be incremented by 1 with each additional section with the same table_id, 
and application_type. 

last_section_number: This 8-bit field specifies the number of the last section (that is, the section with the highest 
section_number) of the sub_table of which this section is part. 

common_descriptors_length: This 12-bit field gives the total length in bytes of the following descriptors. The 
descriptors in this descriptor loop apply for all of the applications contained in this AIT sub_table. 

application_control_code: This 8-bit field controls the state of the application. The semantics of this field is 
application type dependant. See 10.6, "Control of application life cycle" on page 85. 

application_loop_length: This 12-bit field gives the total length in bytes of the following loop containing application 
information. 

application_identifier(): This 48 bit field identifies the application. The structure of this field is defined in 10.5, 
"Application identification" on page 83. 

application_descriptors_loop_length: This 12-bit field gives the total length in bytes of the following descriptors. 
The descriptors in this loop apply to the specific application. 

CRC_32: This is a 32-bit field that contains the CRC value that gives a zero output of the registers in the decoder 
defined in annex B of EN 300 468 after processing the entire section. 

10.4.7 Use of private descriptors in tine AIT 

Private descriptors may be included in the AIT provided that they are in the scope of a DVB-SI [4] private data specifier 
descriptor. The scope rules for the private data specifier descriptor are as follows: 

• If this descriptor is located within any descriptor loop of the AIT, then any specifier identified within this 
descriptor loop applies to all following descriptors and user-defined values in the particular descriptor loop until 
the end of the descriptor loop, or until another occurrence of a private_data_specifier_descriptor. 

• The use of the descriptor in the common (first) descriptor loop does not apply to descriptors or user-defined values 
in the application (second) descriptor loop. 

1 0.4.8 Text encoding in AIT 

Unless otherwise specified, all fields interpreted as text strings in the AIT shall be encoded as UTF8 (see 7.1.5, 
"Monomedia format for text" on page 54). See also 14.5, "Text encoding of application identifiers" on page 222. 

10.5 Application identification 

10.5.1 Encoding 

Each application is associated with an application identifier. This is a 6 byte string with the following structure: 

Table 11 : Application identifier syntax 





No.of Bits 


Identifier 


Value 










application_identif ier ( 
organisation_icl 
application_id 

} 


32 

16 


bslbf 
bslbf 





organisation_id: This 32 bit field is a globally unique value identifying the organisation that is responsible for the 
application. These values are registered in ETSI TR 101 162 [10]. Values of zero shall not be encoded. 
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This field is reproduced in the organisationName field of the subject name in the "leaf certificate of an authenticated 
application (see 12.5.6, "subject" on page 162). 

Note The inclusion of this field in the leaf certificate provides authentication of the value. 

application_id: This 16 bit field uniquely identifies the application function. This is allocated by the organisation 
registered with the organisation_id who decides the policy for allocation within the organisation. Values of zero shall not 
be encoded. 

The application id values are divided into two ranges: one for unsigned applications and one for signed applications. This 
is for security reasons (see 12.1.1, "Overview of the security framework for applications" on page 151). Applications 
transmitted as unsigned shall use an application id from the unsigned applications range and applications transmitted as 
signed shall use an application id from the signed applications range. 

Table 12 : Value ranges for application_id 



application_id values 


Use 


0x0000... OxSfff 


Application_ids for unsigned applications 


0x4000... 0x7fff 


Application_ids for signed applications 


0x8000... Oxfffd 


Reserved for future use by DVB 


Oxfffe 


Special wildcard value for signed applications of an organisation 


Oxffff 


Special wildcard value for all application of an organisation 



Application id values Oxffff and Oxfffe are wild cards. They shall not be used to identify an application but, for example, 
are allowed for use in the External application authorisation descriptor see 10.7.5 on page 92. The value Oxffff matches 
all applications with the same organisation_id. The value Oxfffe matches all signed applications with the same 
organisation_id. 

The same application identifier may be used in different application types for applications performing essentially the 
same flinction. 

The same application_identif ier ( ) shall appear only once within the set of AIT subtables of the same 
application_type inside a service. 

10.5.2 Effects on life cycle 

The main concepts here are: 

• On service change, currently running, previously broadcast, applications whose service_bound_flag is set to "0" 
shall (subject to resource restrictions) continue running if their application identifier is listed in the Application 
Information Table of the newly selected service. 

• On service change, currently running, previously broadcast, applications whose service_bound_flag is set to "0" 
shall (subject to resource restrictions) continue running if their application identifier is suitably listed in the 
External application authorisation descriptor even if they are not part of the current service. 

• Only a single instance of an application with a particular application identifier is allowed to execute at any time. 
So, if an application is already running then another instance of the same application shall not be launched. This 
affects the behaviour with respect to the application launching API and autostart applications after service 
selection. 

• If the application signalling for an application has the "service_bound_flag" is set to "1", then the application is 
killed upon service selection. 

See also S, "(normative): Application Listing and Launching" on page 642. 

10.5.3 Authentication of application identification 

See 12.5.6, "subject" on page 162. 
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10.6 Control of application life cycle 

The broadcast signalling provides a mechanism for broadcasters to control the life cycle of standard application types. 
See also 9.1, "Broadcast MHP applications" on page 61. 

10.6.1 Entering and leaving tine domain of an application 

The domain of an application is defined as the set of services where the application is listed in the AIT. This can be either 
as applications listed in the application (iimer) loop of the AIT or as applications listed in the External application 
authorisation descriptor. Services where the application is not listed in either of these two ways are outside of the domain 
of the application. 

1 0.6.2 Dynamic control of the application life cycle 

The dynamic control of the application life cycle is signalled through the application_control_code for the application in 
the AIT. 

This control code allows the broadcaster to signal to the receiver what to do with the application with regard to its 
lifecycle. The set of codes have some differences between application types and so are defined on an application type 
specific basis. 

If the receiver receives a code that it does not recognise the application shall continue in its current state. 

When a change in these control codes causes a state change of a running MHP application, an 

AppStateChangeEvent shall be generated to all DVB-J applications which have registered to receive such events 
for the application concerned. 

10.6.2.1 DVB-J 

The application control codes for DVB-J applications are listed in 13. 

Table 13 : DVB-J application control code values 



code 


identifier 


semantics 


0x00 




reserved_future_use 


0x01 


AUTOSTART 


The file system element(s) (e.g. an Object Carousel 
module) containing the class implementing the Xlet 
interface is loaded, The class implementing the Xlet is 
loaded into the VM and an Xlet object is instantiated, 
and the application is started subject to usual 
restrictions, etc. 


0x02 


PRESENT 


Indicates that the application is present in the service, 
but is not autostarted. 


0x03 


DESTROY 


When the control code changes from AUTOSTART or 
PRESENT to DESTROY, the destroy method of the 
Xlet is called (with the unconditional parameter set 
to false) by the application manager and the 
application is allowed to destroy itself gracefully. 


0x04 


KILL 


When the control code changes from AUTOSTART or 
PRESENT to KILL, the destroy method of the Xlet is 
called (with the unconditional parameter set to 
true) by the application manager. 


0x05 


reserved_future_use 


0x06 


REMOTE 


This identifies a remote application that is only 
launchable after service selection. 


0x07... OxFF 




reserved_future_use 



See 9.2.3, "DVB-J Application Lifecycle" on page 65. 



ETSI 



86 



ETSITS 101 812V1.3.1 (2003-06) 



10.6.2.2 



DVB-HTML 



The application control codes for DVB-HTML applications are listed in 14. 

Table 14 : DVB-HTML application control code values 



code 


identifier 


semantics 


0x00 




reserved_future_use 


0x01 


AUTOSTART 


The Application Entry Point of tlie DVB-HTML 

application is loaded. This is loaded into the user 

agent, and the DVB-HTML actor is created (in the 

Loading state) and the DVB-HTML application is 

started. 

When these steps are complete the DVB-HTML actor 

is in the Active state. 


0x02 


PRESENT 


Indicates that the DVB-HTML application is present in 
the service, but is not autostarted. 


0x03 


DESTROY 


When the control code changes from AUTOSTART or 
PRESENT to DESTROY, the DVB-HTML actor goes to 
the Destroyed state. 


0x04 


KILL 


When the control code changes from AUTOSTART or 
PRESENT or DESTROY to KILL the DVB-HTML actor 
goes to the Killed state. 


0x05 


PREFETCH 


As for AUTOSTART except that the DVB-HTML 
actor holds on entry to the Active state and waits for a 
trigger before completely transitioning to the Active 
state. 


0x06 


REMOTE 


This identifies a remote application that is only 
launchable after service selection. 


0x07... OxFF 




reserved_future_use 



See 9.3.2, "DVB-HTML Application Lifecycle" on page 72. 

10.7 Generic descriptors 

10.7.1 Application Signalling Descriptor 

The application signalling descriptor is defined for use in the elementary stream loop of the PMT where the streain_ 
type of the elementary stream is 0x05. It identifies that the elementary stream carries an Application Information Table. 

The application signalling descriptor optionally carries a loop of application_type and version_number pairs. These 
allow the descriptor to optionally reproduce the current version number state of the associated Application Information 
Table. This allows the receiver to be informed of the version of the AIT as a side effect of monitoring the PMT (which is 
expected to be monitored closely, under normal conditions). See 10.4.3, "Optimised AIT signalling" on page 81. 

When the MHP detects a change of the content of the application signalling descriptor, it shall acquire the new version of 
the AIT and respond accordingly. 
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The presence of the appHcation_type and AIT_version subfields is optional. If not present then the AIT transmission and 
monitoring applies, see 10.4.2, "AIT transmission and monitoring" on page 80. 

Table 15 : application signalling descriptor syntax 





No.of Bits 


Identifier 


application_signalling_descriptor ( ) ( 






descriptor_tag 


8 


uimsbf 


descriptor_length 


8 


uimsbf 


for ( i=0; i<N; i++ ) { 






application_type 


16 


uimsbf 


reserved_future_use 


3 


bslbf 


AIT_version_number 
} 

} 


5 


uimsbf 



descriptor_tag: This 8 bit integer with value 0x6F identifies this descriptor. 

descriptor_length: This 8 bit field indicates the number of bytes following the descriptor length field. 

application_type: This 16 bit field identifies the application type of an Application Information Table sub-table that is 
on this elementary stream. 

AIT_version_number: This 5 bit field provides the "current" version number of the Application Information Table 
sub-table identified by the application type field. 

10.7.2 Data broadcast id descriptor 

The data broadcast id descriptor is defined for use in the elementary stream information of the PMT. The descriptor 
identifies: 

• the transport format of the data broadcast whose "principal component" is on this elementary stream. 

The semantics of "principal component" is transport protocol specific. 

• the set of application types for any autostart applications delivered by the data broadcast. 

For a single elementary stream more than one data broadcast id descriptor may be used to list additional applications 
types, however, each descriptor shall indicate the same data broadcast id. 

More than one elementary stream may have a data broadcast id descriptor indicating that auto start applications are 
carried by more than one delivery mechanism (for example a single service may have more than one object carousel 
delivering auto start applications). 

10.7.2.1 Generic descriptor 

The data broadcast id descriptor is defined in a generic form by the DVB SI-DAT specification (illustrated in table 16). 
Where no "id specific data" is provided the descriptor just identifies the "principal" component of a data broadcast. 

Table 16 : generic data broadcast id descriptor syntax 





No.of Bits 


Identifier 


Value 










data_broadcast_id_descriptor ( ) { 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




data_broadcast_id 


16 


uimsbf 




for (i=0; i<N; i++) { 








id specific data 
} 

} 


8 


bslbf 
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10.7.2.2 MHP data broadcast id descriptor 

When the data broadcast id is one of those defined by this specification (see table 39) the syntax of the data broadcast id 
descriptor is as shown in table 17. This extends the generic descriptor with an optional list of application types for which 
autostart applications may exist within the data broadcast. This list provides a hint to allow the MHP terminal to prioritise 
connection to a data broadcast when several are provided by the service. If no list is provided then the data broadcast id 
descriptor is silent on the types of autostart applications that may be carried by the data broadcast. If the application list 
is not empty, then the data broadcast shall not include autostart applications of application types other than those in the 
list. It is not required that the data broadcast always include autostart applications of all types in the list. 

Table 17 : MHP data broadcast id descriptor syntax 





No.of Bits 


Identifier 


Value 


data_broadcast_id_descriptor { 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




data_broadcast_id 


16 


uimsbf 




for (i=0; i<N; i++) { 








application_type 
} 
} 


16 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x66 identifies this descriptor. 

data_broadcast_id: This 16 bit field indicates the format of the data broadcast transport protocol. These values are 
registered in ETR 162. 

application_type: This 16 bit field indicates the type of the application (i.e. the engine or plug-in on which the 
application can be executed). See table 10 on page 82. 

10.7.3 Application descriptor 

Exactly one instance of the application descriptor shall be contained in every "application" (inner) descriptor loop of the 
AIT. 

Table 18 : application descriptor syntax 





No.of Bits 


Identifier 


Value 










application_descriptor ( ) ( 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




application_prof iles_length 


8 


uimsbf 




for( i=0; i<N; i++ ) { 








application_prof ile 


16 


uimsbf 




version. ma jor 


8 


uimsbf 




version. minor 


8 


uimsbf 




version .micro 


8 


uimsbf 




service_bound_f lag 


1 


bslbf 




visibility 


2 


bslbf 




reserved_f uture_use 


5 


bslbf 




application_priority 


8 


uimsbf 




for( i=0; i<N; i++ ) { 








transport_protocol_label 
} 
} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x00 identifies this descriptor. 
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application_profiles_length: This 8-bit field indicates the length of the appHcation_profile loop in bytes. 

application_profile: This 16 bit field is an integer value which represents the application type specific profile. This 
indicates that a receiver implementing one of the profiles listed in this loop is capable of executing the application. 

version. major: This 8 bit field carries the numeric value of the major sub-field of the profile version number. 

version. minor: This 8 bit field carries the numeric value of the minor sub-field of the profile version number. 

version. micro: This 8 bit field carries the numeric value of the micro sub-field of the profile version number. 

The four above fields indicate the minimum profile on which an application will run. Applications may test for features 
found in higher (backwards compatible) profiles and exploit them. The MHP terminal shall only launch applications if 
the following expression is true for at least one of the signalled profiles: 

(application_profile e terminal_profiles_set) 

A {(application_version.major < terminal_version.major(application_profiIe)) 
V [(application_version. major = terminal_version.major(application_profile)) 
A ({application_version.minor < terminal_version.minor(application_profile)} 
V { [application_version.minor = terminal_version.minor(application_profile)] 
A [application_version.micro < terminal_version.micro(application_profile)] } ) ] } 

Where: 

e represents "belongs to the set of 

A represents "logical AND" 

V represents "logical OR" 

See table 69, "Profile encoding" on page 232 for the encoding of these values. 

service_bound_flag: If this field is set to "1", the application is only associated with the current service and so the 
process of killing the application shall start at the beginning of the service change regardless of the contents of the 
destination AIT. 

visibility: This 2 bit field specifies whether the application is suitable to be offered to the end-user for them to decide if 
the application should be launched. Table 19 lists the allowed values of this field. 

NOTE: This applies equally to any generic launching menu application provided in the MHP service and to 
any application launching user interface provided in the MHP navigator. 

Table 19 : Definition of visibility states for applications 



visibility 


description 


00 


This application shall not be visible either to applications via an 
application listing API or to users via the navigator with the exception 
of any error reporting or logging facility, etc. 


01 


This application shall not be visible to users but shall be visible to 
applications via an application listing API. 


10 


reserved_future_use 


11 


This application can be visible to users and shall be visible to 
applications via the application listing API. 



NOTE: For example, in a service offering a number of games to the end-user, these values would be used as 
follows: 

GO - the autostart generic launcher application offering the end user the choice of which game to 
launch 

1 1 - the games which the end-user can chose between 

1 - the common server application which all the games use to communicate with a server over the 
interaction charmel. 
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application_priority: This field identifies a relative priority between the applications signalled in this service. 

• Where there is more than one application with the same Application identification this priority shall be used to 
determine which application is started. 

• Where there are insufficient resources to continue running a set of applications, this priority shall be used to 
determine which applications to stop or pause. 

• A larger integer value indicates higher priority. 

• If two applications have the same application identification and the same priority, the MHP may make an 
implementation-dependent choice on which to start. 

transport_protocol_label: This 8-bit field identifies a transport protocol that delivers the application. See transport_ 
protocol_label in Transport protocol descriptor. 

If more than one protocol is signalled then each protocol is an alternative delivery mechanism. The ordering indicates the 
broadcaster's view of which transport connection will provide the best user experience (first is best). This may be used as 
a hint by MHP terminal implementations. It shall be evaluated only once during the life time of the application. 

The protocol selection by the MHP terminal may depend on a variety of factors including user preferences and the 
performance of the transport connections to the terminal. 

10.7.4 User information descriptors 

The user information descriptors complement the "Application descriptor" by providing information suitable for 
presentation to the user (where the "Application descriptor" provides technical information for automatic use by the 
receiver). 

These descriptors are defined for use in the application loop of the AIT. 

10.7.4.1 Application name descriptor 

Exactly one instance of this descriptor shall be included in the application information of an application. The application 
name shall distinguish the application and shall be informative to the user. 

Table 20 : application name descriptor syntax 





No.of Bits 


Identifier 


Value 










application_name_descriptor ( ) ( 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




for (i=0; i<N; i++) { 








ISO_63 9_language_code 


24 


bslbf 




application_name_length 


8 


uimsbf 




for (i=0; i<N; i++) { 








application_name_char 
} 
} 

} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x01 identifies this descriptor. 

ISO_639_language_code: This 24-bit field contains the ISO 639.2 [19] three character language code of the 
language of the following bouquet name. Both ISO 639. 2/B and ISO 639. 2/T may be used. 

Each character is coded into 8 bits according to ISO 8859-1 [20] and inserted in order into the 24-bit field. 
application_name_length: This 8 bit unsigned integer specifies the number of bytes in the application name. 
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application_name_char: This field caries a string (not null terminated) of characters encoded in accordance with 
annex A of ETS 300 468. The string names the application in a manner intended to be informative to the user. 

10.7.4.2 Application icons descriptor 

Zero or one instance of this descriptor shall be included in the application information of an application. It allows icons 
to be associated with the application. The content format for these possible icons shall be restricted PNG as specified in 
section 15.1, "PNG - restrictions" on page 230. 

Table 21 : application icons descriptor syntax 





No.of Bits 


Identifier 


Value 










application_icons_descriptor ( ) ( 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




icon_locator_length 


8 


uimsbf 




for (i=0; i<N; i++) { 








icon_locator_byte 


8 


uimsbf 




icon_f lags 


16 


bslbf 




for (i=0; i<N; i++) { 








reserved_f uture_use 
} 

} 


8 


bslbf 





descriptor_tag: This 8 bit integer with value OxOB identifies this descriptor. 

icon_locator_length: This 8 bit integer specifies the number of characters in the string that prefixes standard icon file 
name. 

icon_locator_byte: This 8 bit value is one byte of the icon locator string. 

The icon locator is the first part of the string that specifies the location of the icon files. This is application tj^e 
dependant. See table 22. The icon_locator shall not end with a "/" slash character. 

Table 22 : Icon locator semantics 



application_type 


description 


0x0000 


reserved_future_use 


0x0001 


For DVB-J this is a patli relative to the base directory of the 
application as defined in 10.9.2, "DVB-J application location 
descriptor" on page 98. 


0x0002 


For DVB-HTML this Is a path relative to the physical root of 
the application as defined in 10.10.2, "DVB-HTIVIL application 
location descriptor" on page 100. 


0x0003... OxFFFF 


reserved_future_use 



icon_flags: This 16 bit field carries a value which is the bitwise OR of the flag bits that identify the icons that are 
provided for the application. The flag bits are defined in table 23. 

Table 23 : Definition of different icon flags (Sheet 1 of 2) 



Icon flag bits 


Description of icon size and pixel aspect ratio 


0000 0000 0000 0001 


32 X 32 for square pixel display 


0000 0000 0000 0010 


32 X 32 for broadcast pixels on 4:3 display (note 1) 


0000 0000 0000 0100 


24 X 32 for broadcast pixels on 16:9 display 


0000 0000 0000 1000 


64 X 64 for square pixel display 


0000 0000 0001 0000 


64 X 64 for broadcast pixels on 4:3 display 
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Table 23 : Definition of different icon flags (Sheet 2 of 2) 



Icon flag bits 


Description of icon size and pixel aspect ratio 


0000 0000 0010 0000 


48 X 64 for broadcast pixels on 16:9 display 


0000 0000 0100 0000 


128 X 128 for square pixel display 


0000 0000 1000 0000 


128 X 128 for broadcast pixels on 4:3 display 


0000 0001 0000 0000 


96 X 128 for broadcast pixels on 16:9 display 


xxxx xxxO 0000 0000 


reserved_future_use 


NOTE 1 : approx. 1 5/1 6 pixel aspect ratio on 50 Hz system 



The file names for the icon files are encoded in a standard way: 

filename = icon_locator "/dvb.icon." hex_string 

hex_string = 4*4hex 

hex = digit I "A" | "B" | "C" I "D" | "E" | "F" | "c 

digit = "0" I "1" I "2" | "3" | "4" | "5" I "6" | "7" 



I "8" I "' 



I "d" I 



I "f" 



An icon file shall contain exactly one icon. The icon contained in the icon file shall have the format specified by the 4 
hexadecimal digit postscript of its file name. 

NOTE: This means that if the icon_f lags field of the application_icons_descriptor were to have a value 
indicating the presence of multiple icons, each of the indicated icons would have its own icon file. 
For example, if icon_flags has a value of 0x0005, the directory specified by icon_locator 
would contain two files named dvb.icon. 0004 (for 64x64 square pixel rendering) and dvb.icon. 0001 
(for 32x32 square pixel rendering). 

10.7.5 External application authorisation descriptor 

The "common" (first) descriptor loop of the Application Information Table may contain zero or more external_ 
application_authorisation_descriptors. Each descriptor contains information about external applications that are allowed 
to continue to run with the applications listed in this Application Information Table sub-table but cannot be launched 
from this service. The external authorization applies to applications with the identified application_identifier() that are of 
the application_type identified by the AIT subtable where this descriptor is contained. 

Table 24 : external application authorisation descriptor syntax 





No.of Bits 


Identifier 


Value 






external_application_authorisation_descr 


iptorO { 






descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




for(i=0; i<N; i++) { 








application_identif ier ( ) 








application_priority 
} 

} 


8 


uimsbf 





descriptor_tag: This 8-bit integer with value 0x05 identifies this descriptor. 

application_identifier(): This 48-bit field identifies an application. The structure of this field is defined in 10.5, 
"Application identification" on page 83. 

application_priority: This 8-bit integer specifies the priority that this application assumes in the context of the current 
service. 

If the Oxffff or Oxfffe wildcard is used for the application_id within the application_identifier() and there are some 
applications from the same organisation_id explicitly signalled in the application loop of the AIT, the priority for those 
applications shall be the one signalled in the application_descriptor (see 10.7.3 on page 88). 

See application_priority under 10.7.3, "Application descriptor" on page 88. 
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10.8 Transport protocol descriptors 

10.8.1 Transport protocol descriptor 

The transport protocol descriptor identifies the transport protocol associated with a service component and possibly 
provides protocol dependent information. 

The descriptor may be used in either the "common" (first) descriptor loop or the "application" (iimer) descriptors loop. 
When in the "common" loop it applies to all of the applications in that sub-table. Any such descriptors in the 
"application" loop describe additional transport protocols available to a specific application. 

Each application described in this section shall be in the scope of at least one transport protocol descriptor. 

Table 25 : transport protocol descriptor syntax 





No.of Bits 


Identifier 


Value 


transport_protocol_descriptor ( ) ( 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




protocol_id 


16 


uimsbf 




transport_protocol_label 


8 


uimsbf 




for(i=0; i<N; i++) { 








selector_byte 
} 
} 


8 


uimsbf 


N1 



descriptor_tag: This 8 bit integer with value 0x02 identifies this descriptor. 

protocoLid: An identifier of the protocol used for carrying the applications. The values of the protocol_id are be 
registered here and in ETR162. 

Table 26 : ProtocoLid 



protocol_id 


description 


0x0000 


reserved_future_use 


0x0001 


IVIHP Object Carousel as defined in annex B, "(normative): 
Object carousel" on page 295. 


0x0002 


IP via DVB multiprotocol encapsulation as defined in 
ETSI EN 301 192 [5], ETSI TR 101 202 [49] 


0x0003... OxOOFF 


reserved_future_use 


Ox0100...0xFFFF 


Subject to registration in ETSI TR 101 162 [10] 



transport_protocol_label: This 8 bit field uniquely identifies a transport protocol within this AIT section. The 
Application descriptor refers to this value to identify a transport connection that carries the application. 

selector_byte: Additional protocol specific information. 

Table 27 : Semantic of selector bytes 



protocol_id 


selector byte data 


0x0000 


reserved_future_use 


0x0001 


See 10.8.1.1 "Transport via OC". 


0x0002 


See 10.8.1.2 "Transport via IP". 


0x0003... OxFFFF 


Not defined in this version of the specification 
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10.8.1.1 Transport via OC 

When the protocol ID is 0x0001 the selector bytes in the Transport protocol descriptor shall be as shown in table 28. 

Table 28 : Syntax of selector bytes for OC transport 



Syntax 


Bits 


Mnemonic 


remote_connection 


1 


bslbf 


reserved_future_use 


7 


bslbf 


if( remote_connection == "l" ) { 






original_network_id 


16 


uimsbf 


transport_stream_id 


16 


uimsbf 


service_id 


16 


uimsbf 


component_tag 


8 


uimsbf 



component_tag: Identifies the "principal" service component that delivers the application. The identified component 
is the elementary stream that carries the DSI of the object carousel. 

remote_connection: This single bit flag if set to "1" indicates that the transport connection is provided by a service 
that is different to the one carrying the AIT. Such applications shall not be autostarted by receivers but are visible (subject 
to the visibility field of the application descriptor) via an application listing API for possible launching by service 
selection (but not via an application launching API). When this bit is set, the following 3 fields (original_network_id, 
transport_stream_id and service_id) are included in the selector bytes. This flag shall be set to "0" when the transport 
connection is provided by the current service. 

Applications with this flag set shall have their application control code set to REMOTE (see table 13 on page 85 and 14 
on page 86). 

See 11.7.2, "Application discovery and launching APIs" on page 132. 

original_network_id: This 16 bit field identifies the DVB-SI original network id of the transport stream that provides 
the transport connection. 

transport_stream_id: This 16 bit field identifies the MPEG transport stream id of the transport stream that provides 
the transport connection. 

service_id: This 16 bit field identifies the DVB-SI service id of the service that provides the transport connection. 

10.8.1.2 Transport via IP 

When the protocol ID is 0x0002 the selector bytes in the Transport protocol descriptor shall be as shown in table 29. 

This structure includes two important components of the data_broadcast_descriptor defined in ETSl EN 301 192 [5]. It 
provides all the information necessary for the MHP to acquire applications and application data components delivered by 
IP protocols. The profiles where this is an optional or mandatory feature are listed in 15, "Detailed platform profile 
definitions" on page 228. 

Table 29 : Syntax of selector bytes for IP transport (Sheet 1 of 2) 



Syntax 


Bits 


IVInemonic 








remote_connection 


1 


bslbf 


reserved_future_use 


7 


bslbf 


if ( remote_connection == "1" ) { 






original_network_id 


16 


uimsbf 


transport_stream_id 


16 


uimsbf 


service_id 


16 


uimsbf 


alignment_indicator 


1 


bslbf 


reserved_f uture_use 


7 


bslbf 
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Table 29 : Syntax of selector bytes for IP transport (Sheet 2 of 2) 



Syntax 


Bits 


IVInemonic 


for ( i=0; i<N; i++) ( 

URL^length 

for(j=0; j<URL_length; j++){ 
URL_byte 

} 
} 


8 
8 


uimsbf 
uimsbf 



remote_connection: This and the associated 3 fields (oi"iginal_network_id, transport_stream_id and service_id) have 
identical syntax and semantics to the fields with the same names under 10.8.1.1, "Transport via OC" on page 94. 

alignment_indicator: This 1-bit field indicates the alignment that exists between the bytes of the datagram_section 
and the Transport Stream bytes (equivalent to the field with this name defined in the ETSl EN 301 192 [5] MPE data_ 
broadcast_descriptor) . 

URL_length: This 8-bit field indicates the number of bytes in the URL. 

URL_byte: These bytes form a URL conforming to IETF RFC 2396 [41]. 

For URL using the "server" field including the host:port notation as defined in IETF RFC 2396 [41], only numeric IP 
addresses shall be used for identifying IP transmissions carried in the broadcast channel as there is no Domain Name 
Service in the broadcast-only scenario to be used for resolving names. 

IP to MAC mapping shall be done as described in IETF RFC 1112 [45]. 

NOTE: This specification intentionally does not define or require any URL format to be supported in this 
descriptor. Hence it cannot be used in an inter-operable way. 

10.8.2 IP signalling descriptor 

The IP signalling descriptor is defined for use either in the "common" or in the "application" loop of the AIT. This 
descriptor indicates the identification of the organisation providing the IP multicast streams used by all applications 
(when present in the "common" loop) or by the particular signalled application (when present in the "application" loop). 
See ETSI EN 301 192 [5] for the definition of the INT. 

This descriptor and the INT with action_type 0x01 shall be used for applications relying on the presence of IP Multicast 
streams on the broadcast link. The knowledge of the identification present in the descriptor enables to recover the 
appropriate IP Notification Table (INT) with action_type 0x01 that contains the correspondence between the multicast IP 
address and port and the stream localisation. 

Table 30 : Syntax of the IP signalling descriptor 



Syntax 


Bits 


Mnemonic 


ip_signalling_descriptor o { 

descriptor_tag 
clescriptor_length 
platf orm_id 
} 


8 
8 
24 


uimsbf 
uimsbf 
uimsbf 



descriptor_tag: This 8-bit field with value 0x1 1 identifies this descriptor 

descriptor_length: This 8-bit field identifies the number of bytes following the length field. 

platform_id: This is a 24 bit field containing a platform_id of the organisation providing IP/MAC streams on DVB 
transport streams/services. 

Allocations of the value of platform_id are found in the ETSI TR 101 162 [10]. 
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10.8.3 Pre-fetch signalling 

10.8.3.1 Introduction 

This signalling is defined to enable implementations to start fetching files that will be required during the early part of an 
application's life. Later in an applications' life it can actively request file pre-fetching using API mechanisms. Descriptors 
in this section do not have a relation to the API-based pre-fetching for this version of this specification. 

For one application, the pre-fetch descriptor(s) and possible DII location descriptor present in the AIT shall point to the 
same transport connection. If the transport_protocol_labels present in these descriptors are different, the referenced 
transport protocol descriptor shall point to the same transport connection (carousel). 

This signalling is optional to broadcast and optional for implementations to consider. 

10.8.3.2 Pre-fetch descriptor 

Zero or one pre-fetch descriptors can be included in the "application" (inner) descriptor loop of the AIT. It is defined for 
use where the protocol_id of the transport is 0x0001 (MHP Object Carousel). Each descriptor is associated with a 
specific Transport protocol descriptor via the transport_protocol_label. 

MHP terminals may use this descriptor to improve application start-up time by pre-fetching modules that have the 
indicated labels (see "Label descriptor" on page 298). 

Table 31 : Syntax of the pre-fetch descriptor 



Syntax 


Bits 


Mnemonic 


prefetch_descriptor () { 






descriptor_tag 


8 


uimsbf 


descriptor_length 


8 


uimsbf 


transport_protocol_label 


8 


uimsbf 


for(i=0; i<N; i++ ) { 






label_length 






for(j=0; j<label_length; j++ ) ( 






label_char 


8 


uimsbf 


pref etch_priority 
} 

} 


8 


uimsbf 



descriptor_tag: This 8-bit field with value OxOC identifies this descriptor. 

descriptor_length: This 8-bit field identifies the number of bytes following the descriptor length field. 

transport_protocol_label: This 8-bit field identifies the Transport protocol descriptor that specifies the object 
carousel that delivers the modules to which this prefetch descriptor refers. See "transport_protocol_label" on page 90. 

Iabel_length: This 8-bit field identifies the number of bytes in the module label. 

labeLchar: These 8-bit fields carry an array of bytes that are a module label. This label matches a label on one or more 
module carried by Label descriptors in the userlnfo fields of the modulelnfo structure of DIIs (see "Label descriptor" on 

page 298). 

The same module label may be attached to several modules. 

prefetch_priority: A value between 1 and 100 (both inclusive). It expresses a pre-fetching hint of the modules with the 
corresponding label using the specified priority (100 highest, 1 lowest). 
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10.8.3.3 DM location descriptor 

For each application zero or one DII location descriptors can be provided. It can be located in either the "common" (first) 
or "application" (inner) descriptor loop of the AIT. It is defined for use where the protocol_id of the transport is 0x0001 
(MHP Object Carousel). Each descriptor is associated with a specific Transport protocol descriptor via the transport_ 
protocol_label. 

The modules that are part of a DSM-CC object carousel are signalled in Downloadlnfolndication (DII) messages. The 
object carousel does not list all the existing DII messages in a single place. 

In order to find all of the modules that match a particular pre-fetch label (see 10.8.3.2, "Pre-fetch descriptor" on page 96), 
it is necessary that all the relevant DII messages can be found. The DII location descriptor lists the locations of these DII. 

If DII location descriptor is not included, then only the DII that signals the module that contains the ServiceGateway 
shall be taken into account when looking for modules matching a particular label. 

The DII identifications in the loop should be sorted on importance. The DII that contains the label(s) with the highest pre- 
fetch priority should be listed first. Receivers that implement module-based pre-fetching should examine the DIIs for 
labels in the order in which they are listed in the DII location descriptor. 

Table 32 : Syntax of the DII location descriptor 



Syntax 


Bits 


Mnemonic 


DII_location_descriptor () ( 






descriptor_tag 


8 


uimsbf 


descriptor_length 


8 


uimsbf 


transport_protocol_label 


8 


uimsbf 


for(i=0; i<N; i++ ) { 






reserved_f uture_use 


1 


bslbf 


DII_identif ication 


15 


uimsbf 


association_tag 

} 
} 


16 


uimsbf 



descriptor_tag: This 8-bit field with value OxOD identifies this descriptor. 

descriptor_length: This 8-bit field identifies the number of bytes following the descriptor length field. 

transport_protocol_label: This 8-bit field identifies the Transport protocol descriptor that specifies the object 
carousel that delivers the modules to which this prefetch descriptor refers. See "transport_protocol_laber' on page 90. 

DII_identification: This 15-bit field identifies the DII message. It corresponds to the identification portion of the 
transactionld. See B.32, "Sub-fields of the transactionid" on page 318. 

association_tag: This 16-bit field identifies the connection (i.e. elementary stream) on which the DII message is 
broadcast. 
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10.9 DVB-J specific descriptors 

10.9.1 DVB-J application descriptor 

One instance of this descriptor shall be contained in the "application" (inner) descriptor loop of the AIT for each DVB-J 
application. It provides start-up parameter information. 

Table 33 : DVB-J application descriptor syntax 





No.of Bits 


Identifier 


Value 


dvb_j_application_descriptor ( ) ( 








clescriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




for(i=0; i<N; i++) { 








parameter_length 


8 


uimsbf 




for(j=0; j<parameter_length; j++) 


{ 






parameter_byte 
} 
} 
} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x03 identifies this descriptor. 
parameter_length: This 8 bit integer specifies the number of bytes in the parameter_byte string. 
parameter_byte: The parameter bytes contain an array of strings that are passed to the application as parameters. 

10.9.2 DVB-J application location (descriptor 

One instance of this descriptor shall be contained in the "application" (inner) descriptor loop of the AIT for each DVB-J 
application. It provides various items of path information to allow the DVB-J application to be found and then operated. 

Table 34 : DVB-J application location descriptor syntax 





No.of Bits 


Identifier 


Value 


dvb_j_application_location_de script or ( 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




base__directory__length 


8 


uimsbf 




for(i=0; i<N; i++) { 








base_directory_byte 


8 


uimsbf 




c las spat h_ext ens ion_length 


8 


uimsbf 




for(i=0; i<N; i++) { 








c las spat h_ext ens ion_byte 
1 


8 


uimsbf 




for (1 = 0; KN; 1 + +) { 








lnltlal_class_byte 
} 

} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x04 identifies this descriptor. 

base_directory_length: This 8 bit integer specifies the number of bytes in the base_directory_byte string. 

The value of this field shall be at least one. 
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base_directory_byte: These bytes contain a string specifying a directory name starting from the root of the file 
system with directories delimited by the slash character "/" (0x2F). This directory is used as a base directory for relative 
path names. This base directory is automatically considered to form the first directory in the class path (after the path to 
the system's classes). 

If the base directory is the root the string shall be "/". 

classpath_extension_length: This 8 bit integer specifies the number of bytes in the classpath_extension_byte string. 

classpath_extension_byte: These bytes contain a string specifying a further extension for the DVB-J class path 
where the classes of the application are searched in addition to the base directory. The class path extension string contains 
path names where the elements in the path are delimited by the semicolon character ";" (Ox3B). The elements of the path 
may be either absolute paths starting from the root of the file system or they can be relative to the base directory. The 
directories are delimited by the slash character "/" (0x2F) and absolute path names begin with the slash character "/" 
(0x2F). 

initial_class_byte: These bytes contain a string specifying the name of the object in the file system that is the class 
implementing the Xlet interface. 

This string is a DVB-J class name that is found in the class path (e.g. "com.broadcaster.appA.MainClass"). The length of 
this string must be at least one. 

10.10 DVB-HTML Specific descriptors 

10.10.1 DVB-HTML application descriptor 

One instance of this descriptor shall be contained in the "application" (inner) descriptor loop of the AIT for each 
DVB-HTML application. It indicates the value of the application parameters and signals the control applied by the 
broadcaster on the state of the application. 

Table 35 : DVB-HTML application descriptor syntax 





No.of Bits 


Identifier 


Value 










dvb_html_application_descriptor ( ) ( 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




appid_set_length 


8 


uimsbf 


N1 


for(i=0; i<Nl; 1++) { 








application_id 


16 


bslbf 




for(j=0; j<N; j++) { 








parameter_bytes 
} 
} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x08 identifies this descriptor. 

appid_set_length: This 8 bit integer specifies the length of the list of application_ids. 

application_id: The values of these 16 bit fields form a set of application ids (see 10.5, "Application identification" on 
page 83). The semantics of this information is not defined in this specification. 

parameter_bytes: The parameter bytes contain the string that is appended to the application initial path as parameters. 

The parameter bytes are joined using simple concatenation, it is the authors responsibility to ensure it is prefixed by a 
legal joining character (such as ? or #) to form a syntactically correct URL. 
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10.10.2 DVB-HTML application location descriptor 

One instance of this descriptor shall be contained in the "application" (inner) descriptor loop of the AIT for each 
DVB-HTML application. 



Table 36 : DVB-HTML application location descriptor syntax 




No.of Bits 


Identifier 


Value 


dvb_html_application_location_descriptor () { 






descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




physical_root_length 


8 


uimsbf 


N1 


for(i=0; i<Nl; i++) { 








physical_root_bytes 


8 


uimsbf 




for(i=0; i<N; i++) { 








initial_path_bytes 
} 

} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x09 identifies this descriptor. 

physical_root_length: This 8 bit integer specifies the length of the physical_root_byte string. 

physical_root_bytes: These bytes contain a string specifying the physical root of the application entry point. The 
semantic of this string is transport protocol specific as shown in table 37 "Transport specific semantic of physical root 
bytes". 

Table 37 : Transport specific semantic of physical root bytes 



protocol_id 


semantic 


0x0000 


reserved_future_use 


0x0001 


A directory specification 


0x0002 


One of the base URLs defined in tiie Transport protocol descriptor 
signalled for the application (see 10.8.1.2, "Transport via IP" on 
page 94). 


0x0003... OxFFFF 


TBD 



initial_path_bytes: These bytes contain a string specifying the URL path component to the entry point document. This 
path is relative to the root defined in the physical_root_bytes field. 

10.10.2.1 Example 

The following example describes the usage of the DVB-HTML application location descriptor. 
An application author designs an HTML application in the following manner: 

• The application data is distributed among several directories, let say an "image" directory and a "main" 
directory. 

• The application entry point is an HTML document called "index . htm" and stored in the "main" directory. 

1 0. 1 0.2.2 Application Entry Point 

From the application author's point of view, the application entry point is specified by the path "main/index . htm". 
This path is stored in the initial_path_bytes string of the location descriptor. 

If the broadcaster inserts this application in a file system sub-directory called "application", the physical_root_bytes 
content of the location descriptor will be the string "application/". 
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If the broadcaster uses a transport via IP for this application, they shall signal the used protocol and IP address in the 
Transport protocol descriptor associated with this application and the physical_root_bytes field shall contain the 
corresponding URL string. 

10.10.3 DVB-HTML application boundary descriptor 

This descriptor is defined for use in the application loop of the AIT. It provides a regular expression that describes the 
data elements that form the application. 

This descriptor is optional. When absent, the application boundary defaults to the complete set of all content coming 
from the transport signalled in the Transport protocol descriptor associated with the application. 

Multiple boundary descriptors can be used for the same application. In this case, the equivalent global regular expression 
is the OR combination (imion) of the individual regular expressions. 

Table 38 : DVB-HTML application boundary descriptor syntax 





No.of Bits 


Identifier 


Value 








dvb_html_application_boundary_descriptor 


( 






descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




label_length 


8 


uimsbf 


N1 


for(i=0; i<Nl; i++) { 








label_bytes 


8 


uimsbf 




for(i=0; i<N; i++) { 








regular_expression_bytes 
} 
} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value OxOA identifies this descriptor. 

Iabel_length: This 8 bit integer specifies the length of the label_bytes string. 

labeLbytes: These bytes contain a string specifying the label that is associated with the set of data identified by the 
regular expression. This label can be used for pre-fetching in a transport specific manner. 

regular_expression_bytes: These bytes contain a string specifying the regular expression that can generate all URLs 
that are in the domain of the application. 

See 9.3.1.4.1, "Regular Expression Syntax" on page 71. 
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10.11 Constant values 

Table 39 : Registry of constant values (Sheet 1 of 2) 



Where used 


Type 


Value 


Where Defined 


Scope 


private data specifier descriptor 


descriptor tag 


0x5F 


PSI & SI tables 


SI 


Data broadcast id descriptor 


0x66 


PMT 


Application Signalling Descriptor 


0x6F 


PMT 


Service identifier descriptor 


0x71 


SDT 


Label descriptor 


descriptor tag 


0x70 


DM modulelnfo 
userlnfo 


SI-DAT 


Caching priority descriptor 


0x71 


Content type descriptor 


0x72 


BlOP objectlnfo 
(note 1) 


reserved to MHP for future OC descriptors 


0x73-0x7F 


OC 


reserved to MHP for future use 


table ID on AIT 
PID 


0x00-0x73 




MHP 


Application Information Table 


0x74 




reserved to MHP for future use 


0x75-0x7F 




reserved for private use 


0x80-0xFF 




Application descriptor 


descriptor tag 


0x00 


AIT 


MHP 


Application name descriptor 


0x01 


Transport protocol descriptor 


0x02 


DVB-J application descriptor 


0x03 


DVB-J application location descriptor 


0x04 


External application authorisation 
descriptor 


0x05 


reserved to MHP for future use 


0x06, 0x07 


DVB-HTML application descriptor 


0x08 


DVB-HTML application location descriptor 


0x09 


DVB-HTML application boundary 
descriptor 


OxOA 


Application icons descriptor 


OxOB 


Pre-fetch descriptor 


OxOC 


DM location descriptor 


OxOD 


reserved to MHP for future use 


OxOE-OxlO 


IP signalling descriptor 


0x11 


reserved to MHP for future use 


0x12-0x5E 


private data specifier descriptor (note 2) 


0x5F 


reserved to MHP for future use 


0x60-0x7F 


User defined (note 3) 


OxBO-OxFE 


MHP Object Carousel 


data broadcast id 


OxOOFO 


PMT AIT 


SI 


reserved for MHP Multi Protocol 
Encapsulation 


OxOOFI 






reserved to MHP for future use 


OxOOFO - OxOOFE 


PMT AIT 


SI 
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Table 39 : Registry of constant values (Sheet 2 of 2) 



Where used 


Type 


Value 


Where Defined 


Scope 


MHP Application Service (see 10.11.1 on 
page 103) 


service type 


0x10 


SDT 


SI 


NOTE 1 : Strictly MessageSubHeader::Objectlnfo in the file message and the bound object info in a file binding of a 

directory or service gateway message. 
NOTE 2: The DVB SI private data specifier descriptor is defined for use in the Application Information Table to 

introduce private descriptors. 
NOTE 3: All user defined descriptors shall be within the scope of a private data specifier descriptor (see 10.4.7, "Use 

of private descriptors in the AIT" on page 83). 



10.11.1 MHP Application Service 

This service type should be used for services which contain at least one auto-start MHP application where this 
application is the main component of the service. If a service signalled with this type contains any broadcast audio or 
video, the navigator shall not start presenting them but leave this to the auto-start application. 

10.12 Service Information 

10.12.1 Service identifier descriptor 

Zero or more service identifier descriptors may be included in the SDT description of a service. Each such descriptor 
defines a single textual identifier for the service. The syntax of this identifier is specified in 14.9.1, "Syntax of the textual 
service identifier" on page 226. 

A single service identifier can be assigned to services in different physical networks even if they have different 
original_network_id and service_id. A given service identifier shall only be associated with services that are 
considered to be the same service. 

NOTE: It is up to the service provider to decide which services are "same" and which are not. For example, 
two services in two different networks where the service have the same programme content but 
different regional adverts could be generally considered to be the "same" service. However, this 
decision is entirely up to the service provider. 

More than one service identifier may be allocated to a service instance. 

Table 40 : Service identifier descriptor 





No.of Bits 


Identifier 


Value 










service_identif ier_descriptor () ( 








descriptor_tag 


8 


uimsbf 




descriptor_length 


8 


uimsbf 




for (i = 0; i < descriptor_length; i++) { 








textual_service_identif ier_bytes 

} 
} 


8 


uimsbf 





descriptor_tag: This 8 bit integer with value 0x71 identifies this descriptor. 

textual_service_identifier_bytes: These bytes contain the unique identifier for a service encoded using the normal 
encoding for text strings in DVB SI. 
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1 1 DVB-J Platform 

11.1 The Virtual Machine 

The DVB-J virtual machine is defined in Java VM [34], as amended by JVM Errata [68] plus the Inner Classes 
specification in Inner Classes [69]. 

The Java Virtual Machine shall support Java class files whose version number is in the range 45.3 through 45.65535. 

11.2 General issues 

11.2.1 Basic Considerations 

Unless otherwise specified in this specification, MHP implementations are not required to include any classes or methods 
marked as deprecated in those API specifications which are either referenced by or included in this specification. Where 
a class is defined by this specification as implementing a specific interface, and that interface requires the class to provide 
an otherwise deprecated method. Then the interface overrides the deprecated mark and the method is required by this 
specification. 

Each DVB-J application instance is considered to logically run in its own virtual machine instance. For this reason, it 
cannot rely on finalizers that are defined in application classes being run when the application terminates. When the 
application manager terminates the entity that represents the virtual machine in which the application is run, a 
conformant implementation is permitted to not run application finalizers, as spelled out in section 2.17.9 of the 
Java VM [34]. 

DVB-J applications shall not synchronize on system classes or other exposed system static objects else undefined 
behaviour may occur. 

Security Exceptions shall only be thrown either where they are declared as part of the description of the method 
concerned or where identified in this specification for those referenced packages which do not include any 
SecurityExceptions. 

It is an allowable implementation choice to not override methods as long as the defined semantics are respected. The 
implication of this is that such differences between implementations will be visible when using the java.lang.reflection 
package. 

The inclusion of Java packages shall not imply the inclusion of other sub packages e.g. the inclusion of the j avax . tv . 
media package does not automatically imply the inclusion of the javax . tv . media . protocol sub package. 
Inclusion of sub packages shall be explicitly listed in this specification. 

DVB-J applications shall not use additional public or protected methods or fields in the org.dvb namespace which are not 
listed in this specification. Applications which scale to run on multiple revisions of this specification shall only use org. 
dvb methods etc. appropriate to the version of the platform on which they are running. 

Applications shall not define classes or interfaces in any package namespace defined in this specification. MHP terminals 
shall enforce this using the SecurityManager.checkPackageDefinition mechanism. 

DVB-J applications that have been written to be scalable across multiple MHP profiles and/or versions of profiles and/or 
optional features may include references to API classes that are only present if the MHP terminal implements the profile 
or version of a profile or an optional feature that these API classes represent. MHP terminals shall ensure that any error 
conditions due to unability to link classes in DVB-J applications are thrown only if the execution of the application 
reaches a bytecode where these classes are referenced from the application. The presence of the reference in the class file 
to an non-existing class shall not lead to an error being thrown when loading the referencing class. 

NOTE: As long as the application properly tests for the presence of these API features prior to calling them 
in a conditional branch, the application shall be able to execute on MHP terminals that do not have 
these API features. 
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1 1 .2.2 Approach to Subsetting 

Where a class included in this specification has methods, fields or constructors with signature dependencies on classes 
not included in the implemented profile, these methods are not required to be present in an implementation. A compliant 
implementation choice may require these methods and classes to be present. 

Where this specification subsets a package, inclusion of the complete package is allowed but clearly not required. The 
behaviour of the additional features is not specified for broadcast applications. 

11.2.3 Class Loading 

The DVB-J application environment shall be written such that each application appears to run within its own classloader 
or classloader hierarchy for all classes that are not a part of the platform. As a consequence, two applications will never 
be able to access the same copy of any application-defined static variable. 

In a signed application, all classes or files to be loaded through the classpath shall be signed by at least the set of 
certificates used to sign the initial xlet class of the application. This applies, for example, to class files comprising the 
application, and images and other data loaded via the java.lang. Class. getResource() mechanism. When authenticating a 
signed application, an MHP terminal can select any one of these certificates to use to authenticate all subsequent classes 
or files loaded. The mechanism used to make this selection is implementation dependent. 

NOTE: Where an MHP terminal trusts more than one of the certificates used to sign the initial xlet, it 
should attempt to select the most trusted of these. 

See 12, "Security" on page 151. 

Inappropriate, meaningless or illegal locators are silently skipped and searching continues. 

11.2.4 Unloading 

Class unloading as defined by section 12.8 of Java Language Spec [32] and section 2.16.8 of Java VM [34] will be 
supported. 

1 1 .2.5 Event listeners 

In org . dvb and org . davic all methods to remove event listeners shall have no effect if the listener is not registered. 

NOTE: The number of threads used to send events to event listeners is intentionally implementation 

dependent. Applications should not block in event listeners as this may prevent other events being 
delivered. 

1 1 .2.6 Event model in DAVIC APIs 

Events defined in DAVIC APIs DAVIC 1.4.1p9 [3] which currently directly extend Java . lang . Object shall extend 
Java . util . EventOb ject. Event listeners defined in DAVIC 1.4. Ip9 [3] shall extend Java . util . 
Event Listener. 

1 1 .2.7 Event model in DAVIC & DVB APIs 

Each class in org. dvb and org. davic inheriting from Java . util . EventOb ject is just a container for these 
fields and no validity checks are done for the parameters by this constructor. Instances of these classes are intended to be 
constructed by the platform implementation and not by applications. The platform implementation will only construct 
these events with the appropriate information passed in. 

In org . dvb and org . davic, unless explicitly specified otherwise, all methods to add event listeners add each 
listener only once if the add method is called with the same parameters multiple times. This means that the same event is 
delivered only once to each listener even if it has been added twice. 

1 1 .2.8 Tuning as a side-effect 

No MHP API shall cause tuning unless explicitly specified as such. For example, if a locator that requires tuning is 
received by the DVBClas sLoader it shall behave as if the specified file is not available. 
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1 1 .2.9 Intra application media resource management 

Where an application makes conflicting requests for limited media decoding resources, the media decoding resources 
that are requested most recently are presumed to be the ones that are most wanted. This applies between MPEG-2 I- 
Frames, MPEG-2 Video "drips" and streaming video. Similarly, this applies between streaming audio and audio fi^om 
memory. 

When a non broadcast media presentation (audio or video from memory or still image) is interrupted by a resource loss 
within the same application, the first presentation is cancelled and will not be restored. 

If a broadcast media presentation is interrupted by a resource loss within the same application, the broadcast presentation 
is restored when the interrupting presentation ends. 

11.2.10 Application thread priority 

The ThreadGroup of application threads shall have aMaxPriority of Java . lang. Thread. NORM_ 
PRIORITY. 

NOTE: As a consequence applications will not be able to create threads at priorities greater than java . 
lang . Thread . NORM_PRIORITY since they don't have Java . lang . 

RuntimePermission ( "modif yThread" ) . Applications may perform compute intensive 
tasks within application created threads without being considered unresponsive. 

11.2.11 Text Encodings 

Where the specification of the Java APIs refers to the default character encoding of the platform, the default for MHP 
shall be "UTF8" as defined in 7.1.5, "Monomedia format for text" on page 54. The encoding "latinl" shall also be 
supported as defined in ISO 8859-1 [20]. 

When present in a Java String, the mark-up codes defined in table D.7, "Codes defined for use in marked-up text files" 
on page 347 shall be encoded in Java chars whose most significant byte is zero and whose least significant byte is the 
value from table D.7 on page 347. The encoding "DVBMarkupUTFS " shall be supported and is defined to be the same 
as UTF8 except as follows: 

• In byte to char translations, the mark-up sequences in table D.7 on page 347 shall be translated into chars as 
defined above. 

• In char to byte translations, sequences of characters matching the encodings above shall be translated into the 
corresponding mark-up code sequences in table D.7 on page 347. 

11 .2.11 .1 Text encoding in Service Information 

Where methods of the DVB SI API or JavaTV APIs access strings encoded in the SI tables and return them to 
applications are String objects, the following character encodings shall be supported as defined in Annex A of the DVB 
SI specification ISO 8859-1 [20]: 

• ISO 6937 (default) 

• ISO 8859-5 through ISO 8859-9 (SI string first byte codes 0x01. ..0x05) 

• ISO 8859-1 through ISO 8859-9 (SI string first byte code 0x10) 

• 16-bit ISO/IEC 10646-1 UCS-2 (SI string first byte code 0x1 1) 

These encodings shall also be supported by the methods in the org . dvb .si.SIUtil class. Support of the other 
character encodings whose signalling is specified in the DVB SI specification is not required from MHP terminals. 
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1 1 .3 Fundamental DVB-J APIs 

11.3.1 Java platform APIs 

The following packages are defined in JAE 1.1.8 API [31]. See also 1 1.8.1.3, "Other classes" on page 139. 

11 .3.1 .1 java.lang package 

The java.lang package is supported with the following modifications. 

a) The following methods shall always throw a SecurityException when called by inter-operable applications: 

Runtime, exec, 
Runtime. load, 
Runtime. loadLibrary, 

Runtime, exit 
System.exit, 
System.load, 
System.loadLibrary, 

b) MHP implementations are not required to include the following methods: 

Runtime. runFinalizersOnExit, 
System.runFinalizersOnExit, 

Thread.destroy, 

Thread.stop, 

Thread, suspend, 

Thread.resume, 

Thread.countStackFrames, 

ThreadGroup. stop, 

ThreadGroup. suspend, 

ThreadGroup . re sume , 

ThreadGroup. allowThreadSuspension 

c) The following fields shall not be used by inter-operable applications: 
System.in 

d) The following classes shall not be used by inter-operable applications: 
java.lang.Process 

e) Applications shall be able to use: 

System.out, 

System.err, 

Runtime. tracelnstructionsO, 

Runtime. traceMethodCallsO 

for debugging without any adverse effects to the application. The output shall not be visible to normal end users 
and shall not conflict with any other API. 

f) The Java . lang . Compiler class and following methods shall be taken as hints from an application to the 
system however there is no guarantee of what happens: 

Runtime. gc(), 
System.gcO 
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g) Only the following properties are required to be supported for System . getProperty ( ) and System . 
getProperties () : 

file, separator, 
path, separator, 
line, separator, 

dvb.retumchannel.timeout (see 1 1.5.3, "Support for IP over the Return Channel" on page 125), 

dvb.persistent.root (see 11.5.6, "Persistent Storage API" on page 126) 

With the exception of dvb . persistent . root all of these properties are accessible to all applications, dvb . 
persistent . root is accessible only as defined in 1 1.10.2.1, "java.util.PropertyPermission" on page 143. 

Property names beginning "dvb . " are reserved for fiiture use. 

h) The System. setProperties and System. setSecurityManager ( ) methods will always throw an 
exception when called by downloaded DVB-J applications. 

i) The class SecurityManager shall be as specified in PersonalJAE [36]. 

j) The in JDK 1.2.2 [78] the methods Java . lang . SecurityManager . checkPackageDef inition and 
Java . lang . SecurityManager . checkPackageAccess are documented to check a package name 
against a list of packages obtained from a method defined in java.security.Security. As the class Java . 
security. Security is not required by MHP, for MHP the documentation of these two methods is 
considered to say that the list of restricted packages is obtained from a platform-specific list. 

MHP terminal implementors are recommended to use this mechanism to prevent application classes from having 
access to implementation classes where this could compromise the security of the MHP terminal. 

MHP terminals shall not use the empty ("") package name-space. 

NOTE: MHP terminal implementors who are also implementing MHP applications need to ensure that the 
namespaces used for applications do not collide with those used for their MHP implementation. 

The call System. currentTimeMillis () shall feature a granularity of the returned time value of not more than 
10 ms. With the call Object .wait (long timeout) , the timeout value is specified as a maximum time to wait. The 
MHP fiirther guarantees that if not notified the object will wait for at least timeout - 10 ms. 

1 1 .3.1 .2 Java. lang. reflect package 

The Java. lang. reflect package is supported. 

11.3.1.3 java.util 

The java.util package is supported. The constants in the Locale class do not imply support (or otherwise) for these 
Locales. Locales supported in the MHP are specified in profiles (see 15.4, "Locale support" on page 23 1). 

The format used for the java.util .Properties . save () and java.util .Properties . load () methods 
shall be that specified for those methods in JDK 1.2.2 [78]. 

The effect of an MHP application calling the Java . util . Timezone . setDef ault method shall be limited to the 
application calling the method. 

11.3.1.4 java.util.zip 

The Java . util . zip package is supported with the exception of the following classes: 

Def later 

Def later Out put St ream 

GZIPOutputStream 

ZipOutputStream 

Adler32 
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11.3.1.5 



Java. 10 



The Java . io package is supported. 

The method Java . io . Ob ject Input St ream. readLine () shall not be called by inter-operable apphcations but 
is required to be present for backwards compatibility with earlier versions of the MHP specification. 

The classes and interfaces in this package relating to files and file systems have additional semantics defined for MHP 
specific file systems as follows. 

• For broadcast carousels in 1 1.5.1.1, "Constraints on the java.io. File methods for broadcast carousels" on 
page 123, 

• For persistent storage in 1 1 .5.6, "Persistent Storage API" on page 126, 

11.3.1.6 java.net 

From the Java . net package, the Java . net . URL and Java . net . InetAddress classes and the exceptions 
MalformedURLException and UnknownHost Except ion only are supported. Unless included in the platform as 
part of a specific profile. All the rest of this package is to be non-supported as defined in section 1 1.2.2, "Approach to 
Subsetting" on page 105. The signature dependencies from these to the rest of this package are severed as described in 
11.2.2, "Approach to Subsetting" on page 105. 

Support is required for at least one implementation dependant j ava . net . URL protocol. Platform methods that return 
a URL to access resources, such as Class .getResource, ClassLoader . getSystemResource and 
ClassLoader . getResource shall return instances of java.net.URL using such a protocol where no appropriate 
protocol is defined in this specification. 

In a signed application, a URL to this resource shall be returned as for an unsigned application, regardless of whether the 
underlying file is signed. When that file is accessed (e.g. via an input stream obtained from j ava . net . URL . 
openStream ( ) ), then if the file fails authentication as described in 1 1.2.3, "Class Loading" on page 105, the system 
shall behave as if the file contained no data (i.e. as if it were a zero-length file). 

NOTE: Due to the overhead of processing the signature verification, asset files which are not critical to be 
authenticated should be loaded using java . io . File or org . dvb . dsmcc . DSMCCOb ject 
and sent as unsigned. 

Support is required for the "file:" protocol. Applications shall be able to construct instances of java . net . URL using 
strings containing "file:" URLs as defined in IETF RFC 1738 [67] where the <host> element is the empty string and 
the <path> element is an absolute filename. 

The method URL . getContent shall work as specified in its specification even though the reference to the URL 
connection is not valid in all MHP profiles. 

The return types of URL.getContent() are defined by the mappings from data type to java class name listed in table 
41 "Return types of URL.getContent()". 

Table 41 : Return types of URL.getContent() 



Data type 


Return type 


Unknown or unsupported data types 


java.io.lnputStream 


text/plain 


java.io.lnputStream 


text/dvb.utfS 


java.io.lnputStream 


text/Generic 


java.io.lnputStream 


image/png 


java.awt.image.lmageProducer 


image/jpeg 


java.awt.image.lmageProducer 


image/mpeg 


org.havi.ui.HBackgroundlmage 
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The behaviour of URL.getContent() responds to data type using information with the following priority: 

a) Content type signalling such as: 

• the content type descriptor in the OC (see B.2.3.4, "Content type descriptor" on page 302). 

• the HTTP header (if supported in the profile) the Content-Type header field (if present) 

b) The filename extension (if known) (see table 5, "File type identification" on page 59) 

c) Open the file & study 

getContentType returns the value contained in the optional content type descriptor in the OC (see B.2.3.4, "Content 
type descriptor" on page 302) if present. 

getFileNameMap returns information derived from table 5, "File type identification" on page 59. 

In the class Java . net . URLStreamHandler, the protected method setURL is not required to be present. 

In the class Java . net . URLConnection, the static methods getDef aultRequestProperty and 
setDefaultRequestProperties are not required to be present. 

See the Object Carousel signalling described in B.2.3.4, "Content type descriptor" on page 302. 

11.3.1.7 Java. beans 

In this package the following classes and interfaces are supported; 

• Beans 

• PropertyChangeEvent 

• PropertyChangeListener 

• PropertyChangeSupport 

• PropteryVetoException 

• VetoableChangeListener 

• VetoableChangeSupport 

• Visibility 

In the Beans class, only the following methods shall be required: 

• Beans . instantiate (ClassLoader cl. String beanName) 

• Beans . isDesignTime ( ) 

• Beans . isGuiAvailable ( ) 

Finally, the following methods shall behave as follows; 

• Beans . isDesignTime ( ) must return "false". 

11.3.1.8 java.math 

From the java.math package Java .math. Biglnteger is supported. 
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11.3.2 MHP platform APIs 

11.3.2.1 org.dvb.lang 

The org . dvb . lang package is supported as defined in annex I, "(normative): DVB-J fiindamental classes" on 
page 363. 

Where no parent is specified at creation, the delegation parent classloader of DVBClassLoader shall be the original 
classloader of the calling application. 

Classloader delegation is defined in the specification for java . lang . ClassLoader in PersonalJAE [36]. 

11.3.2.2 org.dvb.event 

The org . dvb . event package is supported as defined in annex J, "(nonnative): DVB-J event API" on page 367. 

When sending events from a org . dvb . event . EventManager to listeners, the implementation shall ensure that 
any single listener shall only be sent one platform generated event instance at one time. If a new event is generated before 
the listener method has returned from processing a previous event, the MHP terminal shall not call that listener method 
until the call for processing the previous event returns. 

The behaviour where applications have multiple such event listeners registered is implementation dependent. 
Implementations may use multiple threads to send the same event instance to any such multiple listeners. 
Implementations may ensure that at most one event listener in any one application for all these events is executing at any 
one time. 
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11.4 Presentation APIs 

1 1 .4.1 Graphical User Interface API 
11.4.1.1 The Core GUI API 

The following package is defined in JAE 1.1.8 API [31]. 

The following classes and interfaces from the j ava . awt package are included in the MHP specification: 



• Adjustable 

• AWTError 

• AWTEvent 

• AWTEventMulticaster 

• AWTException 

• BorderLayout 

• CardLayout 

• Color 

• Component 

• Container 

• Cursor 

• Dimension 

• EventQueue 

• FlowLayout 

• Font 

• FontMetrics 

The entire java.awt.event package is included. 



• Graphics 

• GridBagConstraints 

• GridBagLayout 

• GridLayout 

• IllegalComponentStateException 

• Image 

• Insets 

• ItemSelectable 

• LayoutManager 

• LayoutManager2 

• MediaTracker 

• Point 

• Polygon 

• Rectangle 

• Shape 

• Toolkit (as detailed below) 



Property names for use with the getProperty method on Java . awt . Image and its sub classes beginning "dvb." 
are reserved for fiiture use. 

See also 11.8.1.3, "Other classes" on page 139. 

The signature dependencies from Component to PopUpMenu (the add method) and MenuComponent (the remove 
method) are severed as described in 11.2.2, "Approach to Subsetting" on page 105. The same applies for all references to 

the Java . awt . peer package. In Component and Container, the list methods are not required. 
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In the Toolkit class, the following methods are required: 

• getDef aultXoolkit, 

• getFontList, 

• getFontMetrics, 

• sync, 

• getColorModel, 

• and all the methods relating to images. 

The following two methods are added to the Toolkit class from PersonalJAE [36]. These two methods shall not cache 
java.awt. Image objects. 

• public abstract Image createlmage (String filename); 

• public abstract Image createlmage (URL url); 

The image caching behaviour of the following two methods is now observed as explicitly specified in PersonalJAE [36]. 
These two methods cache java.awt.Image objects so that two calls with the same argument return the same object. 

• public abstract Image getlmage (String filename); 

• public abstract Image getlmage (URL url); 

Applications shall be able to use Toolkit.beep without any adverse effects to the application. The output is not required to 
be audible to normal end users and shall not conflict with any other API. 

The methods getScreenResolution and getScreenSize shall be supported with the additional semantics 
described in HAVi [50]. 

All of the java.awt.Image package is required. The encoding of image content types for use by java.awt.Image are defined 
in 7.1.1, "Bitmap image formats" on page 52. The set of formats supported is profile dependent. 

When using the java.awt. FontMetrics class, the width of a set of characters or string returned by the chars Width or 
stringWidth method shall be correct taking into account any kerning and sub-pixel positioning applied by the font 
renderer. Calculating the same number by adding the widths of the individual characters is not required or expected to 
return the same number since it will not take into account any kerning or sub-pixel positioning applied by the font 
renderer. 

The downloading of fonts from the network (see D.2.2, "Downloaded fonts" on page 330) shall be supported using the 
methods concerned on org . dvb . ui . FontFactory. Failure to download a font shall be reported by these methods. 
The constructor for j ava . awt . Font shall only be aware of platform resident fonts. 

11.4.1.2 TV user interface 

The packages org . havi . ui and org . havi . ui . event defined in HAVi [50] shall be supported. Instances of 
org . havi . ui . event . HRcEvent are reported through the normal j ava . awt event mechanism due to the 
inheritance from Java . awt . event . KeyEvent. 

With the exception of the HSound . load method, no methods specified in HAVi [50] shall throw a security exception in 
the MHP context. The permissions for HSound. load are those defined for Java. io. 

The DVBTextLayoutManager specified in U, "(noraiative): Extended graphics APIs" on page 687 shall be 
supported. 
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The following semantics shall be used for the getVideoController method on HVideoDevice. 

• It shall only return JMF players (see Java Media Player Specification [33]) which are in the Prefetched or Started 
states and which are using that HVideoDevice as one of their scarce resources. Otherwise null will be returned. 
It shall not return JMF players from other applications if those are using the video device underlying the 

HVideoDevice. 

• Except as specified below, it shall only return JMF players which have been aheady created in response to the 
application calling javax .media .Manager . ere at eP layer or which have been returned by javax . tv. 
service . selection . ServiceContext . get ServiceContent Handlers (see Java TV [51]) . 

• The only exception to the above is the situation where video is being played in the background as part of the 
context of an application but where javax . tv. service . selection . ServiceContext . 
getServiceContentHandlers has not yet been called. In this case, getVideoController shall return 
the same JMF player as would be returned by getServiceContentHandlers if it was to be called 
subsequently. 

The signatures of the classes HComponent and HContainer shall be extended with "implements org . dvb . 
ui . TestOpacity". 

The methods HGraphicsConf iguration . getPunchThroughToBackgroundColor shall not be used by 
inter-operable applications. 

The methods fontAvailable ( ) and downloadFont ( ) in the class org.havi .ui . HFontCapabilities 
shall not be used by inter-operable applications. 

The package javax . tv . graphics defined in Java TV [51] shall be supported. 

Applications shall only pass in calls to the method javax. tv. graphics . TVContainer . get Root Container 
the exact same XletContext instance as was passed to their initXlet method when it was called by the MHP 
terminal. The behaviour of getRootContainer if passed any other XletContext is implementation dependent 
and returning null is one valid option. Except for this case, this method shall never return null in an MHP 
implementation. 

The method HComponent . isDoubleBuf f ered shall not be used by inter-operable applications. 

11.4.1.3 Extended graphics 

See U, "(normative): Extended graphics APIs" on page 687. 

11.4.1.4 Handling of input events 

The MHP includes two ways for applications to receive input events: the normal AWT method in j ava . awt . 
Component and the org . dvb . event package (see 1 1.3.2.2, "org.dvb.event" on page 1 11). Via the normal AWT 
method, the application normally receives all input events when the component has the focus. The minimum set of input 
events that are supported is defined in G.5, "Input events" on page 359. 

Often the resident Navigator software of the MHP terminal uses many of the keys on the remote control for its own 
navigation purposes. The navigator shall not act on input events which are delivered to MHP applications. In particular, 
the navigator shall not respond to number key input if that input is delivered to one or more MHP applications. 
Conversely, if the MHP application with input focus has indicated disinterest in number key input (using HScene . 
setKeyEvent s with an HEventGroup not including the number keys) then navigators which respond to number key 
input are free to do so. Rules on when MHP applications should request interest in particular input events and when they 
should not are found below. 
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To ensure consistent user experience, the following rules are defined: 

• an application creating an HScene and placing components into it shall not by default get the input focus for 
these components 

• the application may request to get the input focus by calling Component.requestFocusO.Ifthisis granted 
and the focus moved to the requested component, this component shall receive input events as defined in J. 1 on 
page 367. 

• the application may request to receive a subset of input events via the org . dvb . event API even when not 
having the AWT focus. 

For applications delivered within normal television services, it is recommended that the following items are taken into 
account: 

• when the display is primarily showing the video of the television service and the user perception is that he is not 
actively interacting with an application but is just watching the television service (this state is later 

called 'television viewing mode'), the applications should not request the AWT focus but let most of the input 
events go to the resident Navigator (e.g. number keys, directional arrow keys and Enter may cause the normal 
actions the user expects from the Navigator) 

• in the 'television viewing mode' the applications should request only the minimum required input events, e.g. only 
input events that cause some further action to happen and that may transition the user from the 'television viewing 
mode' into a state where the user more actively interacts with the applications. 

• if the applications require some input events for the user to be able to activate the application when in 

the 'television viewing mode', it is recommended that the VK_COLORED_KEY_(0. . .3) and VK_TELETEXT 
(see note below) input events are used for this purpose and the applications request them via the org.dvb.event 
API. In practice this means that the navigator can not map any essential function directly to the VK_ 
COLOURED_KEY(0. . .3) events in television viewing mode. 

• MHP applications wishing to leave "tv viewing mode" and receive events other than the VK_COLORED_KEY_ 
(0. . .3) and VK_TELETEXT are obliged to display a non-transparent graphics object on the screen that covers at 
least 3 % of the visible area on the screen (equivalent to 9852 pixels on a 634x518 visible screen in a 720x576 
graphics mode) which clearly indicates to the user the "non-navigator" mode of the receiver with respect to input 
event handling. 

NOTE 1 : In television services where DVB Teletext is transmitted within the service, a typical Navigator 
action in the 'television viewing mode' can be to activate a teletext decoder, if supported by the 
terminal. The application requesting this input event may cause the DVB Teletext decoder not to be 
conveniently accessible to the end user. Therefore, within services that carry DVB Teletext it is 
recommended that the VK_TELETEXT input event is requested in the 'television viewing mode' 
only by such applications that provide a simulcast MHP application version of the teletext service, 
thus providing a replacement for the DVB Teletext information. 

In environments where WST Teletext services are prevalent when there is no DVB Teletext service 
associated with the video service, the MHP application should display an information service of a 
similar nature to teletext. When receiving this event for the second time the information service 
should terminate and the user will return to normal viewing mode. 

The VK_TELETEXT event should have no other purposes in MHP applications. 

NOTE 2: The items above apply only to the 'television viewing mode' as explained above. In states where the 
user experience is that the user is clearly primarily interacting actively with an application the 
applications can naturally use the normal AWT input event mechanism and request the focus as well 
as use any of the supported input events via the org.dvb.event API. 

NOTE 3: For data services, the first interaction state of an application that is automatically started after 

service selection should behave as television viewing mode. This is in order to allow users who are 
navigating with the navigator to seamlessly navigate through these services without getting 
confused. 
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11.4.1.5 Font bindings 

11.4.1.5.1 PFRO 

For fonts in the PFRO format 7.4, "Downloadable Fonts" on page 55, the bindings between the Java APIs relating to font 
metrics and the font format itself shall be as follows; 

The return values of the methods FontMetrics . getMaxAscent and FontMetrics . getMaxDescent shall be 
yOf f setTop and yOffsetBottom respectively as defined in D. 3. 5. 3, "Conversion of units" on page 336. 

For PFR fonts with the auxiliary data record; 

• FontMetrics . getAscent shall be obtained from the ascent field 

• FontMetrics . getDescent shall be obtained from the descent field 

• FontMetrics . getLeading shall be obtained from extemalLeading. 

All values in the auxiliary data record shall be converted from font metrics units to pixels as described in D.3.4, 
"Converting font metrics to display pixels" on page 335 before being returned. This conversion shall round up. 

For PFR fonts without the auxiliary data record; 

• FontMetrics . getAscent shall be the same as getMaxAscent 

• FontMetrics . getDescent shall be the same as getMaxDescent 

• FontMetrics . getLeading shall be zero. 

The "advance width" of a character, in metrics units, is defined as follows: 

• For PFR fonts with the "proportionalEscapement" flag set, the advance width of a character is given by the 
"charSetWidth" field in the character record. 

• For PFR fonts without the "proportionalEscapement" flag set, the advance width of a character is given by the 
"standardSet Width" field in the physical font record. 

Java . awt . FontMetrics . charWidth ( ) shall return the advance width of the character converted to pixels. This 
conversion shall round up. 

Java . awt . FontMetrics . stringWidth ( ) , Java . awt . FontMetrics . bytes Width ( ) and Java . 
awt . FontMetrics . charsWidth ( ) are calculated by summing the advance widths of all the characters in the 
string, and adjusting for any kerning in the font. Adjustments for kerning are performed in metrics units, then the result is 
converted to pixel units. This conversion shall round up. 

Java . awt . FontMetrics . getMaxAdvance ( ) returns the maximum value that Java . awt . FontMetrics . 
charWidth ( ) can return. Note that for proportional fonts the implementation must calculate this value from the 
advance width of every character in the font; there is no field in the PFR file which contains it. 

1 1 .4.2 Streamed Media API 

11.4.2.1 Framework of solution 

The javax. media and javax. media .protocol packages from Java Media Framework as defined in Java Media 
Player Specification [33] shall be implemented with the clarifications, extensions and restrictions as defined in the 
corresponding sections below. 

11.4.2.2 Clarifications 

The JMF "time base time" when playing MPEG content delivered in MPEG transport streams is used as a constantly 
progressing time whose rate may be synthesized from the Program Clock References / the System Time Clock in MPEG 
or by some other appropriate method. The value does not have any direct relation to the value of the MPEG System Time 
Clock in the receiver. 
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The media time of JMF when playing MPEG content dehvered in MPEG transport streams is just a time value that 
progresses as the media stream is played, but whose actual value is implementation dependent. 

NOTE: There is no implied or expected connection between the JMF media time and any time base(s) 
provided by the MPEG-2 / DSM-CC Normal Play Time. 

When creating a JMF player, Locators and URLs which reference a DVB service, event or elementary stream will create 
a player which plays the content concerned direct from the network. Locators and URLs which reference files will create 
a player which will download the content concerned from the network during the Prefetching state of the player 
concerned. If the content cannot be downloaded then such players will never enter the Prefetched state. 

Interoperable applications shall not call javax.media.MediaHandler.setSource(). 

In the javax .media . PackageManager: 

a) The effect of the set<xxx>PrefixList methods is limited to the application calling the method. 

b) The SecurityException of the commit<xxx> methods shall always be thrown in MHP 

The events javax. media. ControllerEvent and javax .media . GainChangeEvent shall inherit from 

Java .util .EventOb ject. 

The interfaces javax .media . ControllerListener and javax .media . GainChangeListener 
shall inherit from Java . util . EventListener. 

SubtitlingLanguageControl . isSubtitlingOn ( ) returns the current state of subtitle presentation and NOT 
the last value set with set Subtitling. In particular set Subtitling maybe set to true but if there are no subtitles 
in the network or no subtitle service component selected then isSubtitlingOn shall return false. 

Any elements in DVBLocator s after and including the event_id element are ignored by JMF players. 

1 1 .4.2.3 Default media player behaviour 

For a JMF player which is presenting a DVB service, the following rules will be followed in the order given to decide 
which service components will be presented when multiple audio, video or subtitle components are present in a service: 

a) For audio and subtitle streams in different languages, user preferences will be used to determine which streams 
are selected. 

b) The streams which are first in the network signalling information (i.e. in the PMT) will be presented. 

If any of the media components comprising the service change then the implementation will as far as possible replace the 
changed components with suitable replacements in a user preference and implementation dependant manner. 

1 1 .4.2.4 Required controls for video drips 

The following controls are supported for video drips (see 7.1.3, "MPEG-2 Video "drips"" on page 52): 
javax . tv .media . AWTVideoSizeControl 
org . dvb .media . BackgroundVideoPresentationControl 

1 1 .4.2.5 Extensions to the Framework 

1 1 .4.2.5.1 DVB specified extensions 

The classes and interfaces defined in annex N, "(normative): Streamed Media API Extensions" on page 495 of this 
specification are included. 

If a Player bound to a DripFeedDataSource receives a ResourceWithdrawnEvent and later a 
ResourceReturnedEvent, the video output from the video decoder to which the player is bound is implementation 
dependent. The MHP application using the Player shall call the DripFeedDataSource . feed method with an 
I-frame as soon as possible after ResourceReturnedEvent is received. 
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NOTE: Application developers should take this into account when constructing video drip sequences. A 
large number of P-frames between I-frames could lead to a significant delay before the visible 
display can be refreshed due to the limitations on the frequency with which new data can be fed to 
the decoder. 

1 1 .4.2.5.2 Extensions in org.davic 

The following classes and interfaces will be included from the org . davic . media package, as defined in annex L of 
DAVIC 1.4.1p9[3]. 

• MediaPresentedEvent • LanguageNotAvailableException 

• MediaLocator • NotAuthorizedException 

• MediaTimePositionControl • NotAuthorizedMediaException 

• FreezeControl • MediaFreezeException 

• ResourceWithdrawnEvent • LanguageControl 

• ResourceRetumedEvent • AudioLanguageControl 

• MediaTimePositionChangedEvent • SubtitlingLanguageControl 

The following classes will be included from the org . davic . media package as defined in annex L of DAVIC 1.4. 
Ip9 [3] with the following semantic modification: 

• The completion of the action started by calling setMediaTimePosition() on the 

MediaTimePositionControl will be signalled by a org. davic .media . 
MediaTimePositionChangedEvent. 

• The org. davic .media .MediaPresentedEvent shall only be thrown following changes caused using 
controls in the org . davic package and as part of the transition of a JMF player into the Started state. In this 
second case, it augments the JMF state transition events and does not replace them. 

NOTE: Changes effected using javax. t v. media. MediaSelect Control do not lead to the org. 
davic .media .MediaPresentedEvent being thrown. 

NOTE: This specification defines more specific conditions under which ResourceWithdrawnEvent 
and ResourceRetumedEvent than the original DAVIC specification. This can be found in 1 1. 
6.2, "Service Selection API" on page 128. 

1 1 .4.2.5.3 Extensions in javax. tv 

The package javax. tv. media defined in Java TV [51] shall be implemented. 

In javax . tv .media .MediaSelectControl the Insuf f icientResourcesException is thrown by the 
select ( ) method if selecting any service component fails due to a lack of system resources. 

In javax. tv. media . AWTVideoSize . equals () , the "data members" shall be considered to be the "source" and 
"dest" parameters used to create the object. 

The components returned by javax . t v. media .MediaSelectControl . get Cur rent Select ion are the 
currently selected components which may be different from those previously selected by this control. Mechanisms which 
may modify the current selection include: 

• control of subtitles & audio language 

• the CA system including the common interface e.g Host Control replace / clear_replace 

• user intervention via the navigator 
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The following clarifications shall apply to the method getDe fault Size in javax. tv.media . 
AWTVideoSizeControl: 

a) This method shall return the current default AWTVideoSize. The default shall be that which would be 
implemented by the MHP terminal when the video scaling & positioning of a JMF player is under control of the 
MHP platform (see org . dvb . media . VideoFormatCont rol . DFC_PLATFORM). When the video scaling 
and positioning is in the DFC_PLATFORM mode, the return value of this method shall change to track changes 
made by the policy underlying DFC_PLATFORM. 

b) Calling AWTVideoSizeControl . setSize () with the AWTVideoSize object returned by this method as 
the parameter shall set the video scaling to the current default at the time getDef aultSize ( ) was called. 
Hence it shall be equivalent to calling BackgroundVideoPresentationControl . 
setVideoTransf ormation with the video transformation returned by the method 

VideoFormatControl . getVideoTransf ormation (getDecoderFormatConversion ( ) ) and 
not with the video transformation returned by getVideoTransf ormation (DFC_PLAFORM) . 

NOTE: When the MHP terminal is in pan & scan mode, (see org . dvb . media . 

VideoFormatControl . DFC_PROCESSING_PAN_SCAN), the return value of 
AWTVideoSizeControl . getSize ( ) will be out of date almost as soon as the method has 
returned. 

1 1 .4.2.5.4 Required controls for broadcast profiles 

The following controls are supported for the broadcast streaming formats specified in 7.2, "Broadcast streaming formats" 
on page 54: 

org.davic.media.LanguageControl 

org.davic.media.AudioLanguageControl 

org.davic.media.SubtitlingLanguageControl 

org.davic.media.FreezeControl 

javax. tv.media.MediaSelectControl 

javax. tv.media.AWTVideoSizeControl 

org.dvb.media.VideoPresentationControl 

org.dvb.media.BackgroundVideoPresentationControl 

org.dvb.media.SubtitlingEventControl 

org. dvb.media. VideoFormatControl 

org.dvb.media.DVBMediaSelectControl 

The following controls are supported for media decoded from 7.1.4, "Monomedia format for audio clips" on page 54: 

• org.davic.media.MediaTimePositionControl 

11.4.2.5.5 Clarifications 

In SubtitlingLanguageControl, subtitling being presented shall be defined as the subtitle decoder running. It does not 
require subtitles to be visible on screen at that time. See 13.5, "Subtitles" on page 214. 

When a PresentationChangedEvent is generated, the Player in question should re-evaluate the list of controls 
returned by the getControls() method for that player. Similarly, Players supporting the MediaSelectControl should 
re-evaluate the list of Controls returned by getControls ( ) after calls to the MediaSelectControl . select ( ) 
method is called. 
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Any controls referenced by an application after a PresentationChangedEvent or a 

MediaSelectSucceededEvent is generated may fail silently if they are no longer valid. Controls which are valid 
for the new content remain unaffected. Applications should re-acquire any controls they require after either of these 
events has been generated. 

If the content being presented by a JMF player becomes unavailable due to tuning, org . davic . media . 
ResourceWithdrawnEvent shall be sent to listeners registered to receive that events. A 
ResourceReturnedEvent shall be sent to all listeners registered at that time if the content becomes available again. 

1 1 .4.2.6 Restrictions on tlie Framework for Broadcast 

Controls that are supported the MHP need not have an associated GUI component. Any calls to Control . 
getControlComponent () may return null. 

Developers of MHP applications should not rely on the presence of the following classes or interfaces: 

javax .media . CachingControl (unless returned by a call to a JMF method) 

javax .media . CachingControlEvent 

javax .media . GainControl (unless returned by a call to a JMF method). 

An MHP implementation need not return a CachingControl or GainControl from a call to Player . 
getControls ( ) however this is not prohibited. If an MHP implementation does return a GainControl, then the 
volume that is set using this control may not be greater than the system volume level. I.e. the gain control may only 
change the volume between mute and the volume level at the time the application was started. This system volume level 
shell be represented as 1.0. 

JMF Players are not required to return a Java . awt . Component from their getVisualComponent method and 
may return null. Players which return null can only be used to present video in the background. Players which return a 
Java . awt . Component must fully support the semantics for Java . awt . Component concerning positioning and 
scaling. 

Players start as background players. If a getVisualComponent returns a component then a player is also capable of 
performing as a component based player. Video shall continue running in the background until the first call to the paint 
method of the component returned getVisualComponent. When this transition happens the video is resized and 
repositioned as required by the visualComponent. Possible areas outside of the component are updated to follow the 
rules in 13.3, "Graphics" on page 202. 

After this transition, applications shall re-acquire the list of JMF controls for the player. It is implementation dependent 
whether any previous JMF controls are re-used. Applications shall not use any previous JMF controls which are not in 
the new list of JMF controls. When a JMF player is performing as a component based player, the following JMF controls 
shall not be supported and video scaling & positioning shall be done by controlling the size & position of the component 
returned by the getVisualComponent method. 

org . dvb .media . BackgroundVideoPresentationControl 

javax . tv .media . AWTVideoSizeControl 

Applications should not expect PushDataSource and Pul ID at a Source to exist for broadcast MPEG content, and 
it is not required that functional implementations be provided for implementations of JMF in DVB. The DataSource 
used may be implementation-specific and non-specified apart from its inheritance from j avax . media . protocol . 
DataSource. 

The constructor for URLDataSource may always throw lOException for broadcast MPEG content. 

For the purposes of integration with javax . t v. media .MediaSel ect Control "resynchronization" is not 
considered to occur provided that the same PCR_PID is referenced between the new and existing service components. 

Implementations of JMF shall not tune but shall allow selection of media components from transport streams which can 
be reached without tuning even where they are not part of a currently selected service. 
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The failure modes if a locator is used which cannot be reached without tuning are defined as follows; 

• For a JMF player which is a ServiceMediaHandler, the failure modes are fully specified in the description 

of MediaSelect Control. 

• If a JMF player which is not a ServiceMediaHandler is created with such a locator then it shall not be able 
to enter the Realized state. 

The Realizing state shall be exited with the posting of a ResourceUnavailableEvent. 

• For JMF players which are not ServiceMediaHandlers, MediaSelectControl shall be restricted to 
operating only on service components belonging to transport streams currently available without tuning. 

NOTE: In this version of this specification, no media types are defined for which j avax . media . 
Player . addCont roller can have any other behaviour apart from throwing a 

IncompatibleTimeBaseException. 

11.4.2.7 Intersection Between MediaSelectControl and 
SubtitlingLanguageControl / AudioLanguageControl 

The method org. davic. media. LanguageControl . listAvailableLanguages () shall list all available 
languages in the service concerned. This includes languages canied in service components which are not currently 
selected, either because the service component concerned has been de-selected using MediaSelectControl or 
because it was never selected initially because it was not carried in one of the components listed in the component tags of 
a locator which included component tags. 

The method org. davic. media. LanguageControl . selectLanguage () shall over-ride any selection of 
service components made either by javax . tv . media . MediaSelectControl or by using a locator for a service 
which included component tags. If selectLanguage ( ) has changed the set of service components selected, the 
methods on javax . t v. media .MediaSelectControl shall behave as if that change had been made through 
MediaSelectControl and return the correct set of service components taking into account the change made by 
selectLanguage ( ) . 

If the methods on javax .t v. media .MediaSelectControl are used to replace or remove the service 
component carrying the currently active audio or subtitles then the presentation of this service component shall stop. If 
the methods on javax . media . MediaSelectControl are used to add a service component carrying audio or 
subtitles when a service component of this media type is not already being presented then presentation of this service 
component shall be started. The language of the newly selected service component shall be returned by calls from the 
application to the method getCurrentLanguage on AudioLanguageControl or 

SubtitlingLanguageControl respectively. Attempting to select multiple service components of the same media 
type to be presented at the same time using methods on MediaSelectControl shall fail unless the MHP terminal 
concerned has sufficient resources to present them simultaneously. The failure mode shall be that as specified in 
MediaSelectControl for when insufficient resources are available. 

Control of the availability of subtitles using MediaSelectControl or the methods selectLanguage & 
selectDef aultLanguage (which SubtitlingLanguageControl inherits from LanguageControl) shall 
not impact the value of "Application Control" as mentioned in figure 34, "Determining subtitling language and 
presentation setting" on page 214 and vice versa. 

1 1 .4.2.8 Intersection between Streamed Media API and TV User Interface API 
11.4.2.8.1 Basic Principles 

Some of the decoder format controls pre-defined as part of org . dvb . media . VideoFormatControl may require 
control over the pixel aspect ratio of the final video output signal after video, graphics and backgrounds have been 
combined as shown in figure 17 on page 198. In order to enable this, a JMF player shall attempt to reserve the 
HVideoDevice instance on which its output is being displayed. Failure to reserve the HVideoDevice shall not be 
considered fatal to the JMF player but may result in an inferior TV video presentation. 
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NOTE: The actual configurations of the HVideoDevice used and available are dependent on the precise 
configuration of the MHP terminal. Differences will exist between set-top boxes, integrated digital 
TVs and PCs. The precise nature of any "inferior TV video presentation" is dependent on the 
configuration of the MHP terminal, on the input video and the characteristics of the final output 
device. 

If the JMF player from which an HVideoComponent was obtained is in either the prefetched or started states then the 
associated HVideoDevice shall be the one on which that JMF players video is being displayed. If the JMF player is in 
another state then there may not be an associated HVideoDevice. 

11.4.2.8.2 TV Behaviour Control 

The "TV Behaviour Control" in figure 31, "Format control in the presence of a JMF player" on page 21 1, is the default 
video transfonnation behaviour for JMF players which have none other set. Setting the VideoTrans format ion to 
DFC_PLATFORM shall set the video format control to TV behaviour control mode. 

NOTE 1 : In this mode, any changes in the video input signal where "television behaviour control" requires 
changing the pixel aspect ratio of the final output signal (i.e. after the combination of video with 
graphics, subtitles & backgrounds) will also change the pixel aspect ratio of any graphics, subtitles 
& backgrounds combined into that one final output signal. 

NOTE 2: For an example of "TV behaviour control" in set-top boxes and integrated digital TVs, see 
E-Book [I]. 

1 1 .4.2.8.3 Application Behaviour Control 

When an MHP application is controlling video presentation through BackgroundVideoPresentationControl 
(for video in the background) or VideoPresentationControl & methods on Java . awt . Component (for 
video in a component), the application is responsible for monitoring the incoming video format & changing the video 
presentation if desired. 

Instances of VideoTrans format ion constructed using the constructor of that class shall not impact the 
configuration of the HVideoDevice. Instances of VideoTransf ormation returned by 

VideoFormatControl. getVideoTransf ormation shall have the same impact on the HVideoDevice as the 
equivalent conversion applied in "TV behaviour control mode". These may not be fully achievable if the JMF player does 
not have the HVideoDevice reserved. 

1 1 .4.2.8.4 Dynamic Behaviour 

A JMF player shall attempt to reserve the HVideoDevice instance on entry to the Prefetched state from any state 
except the Started state. A JMF player in the prefetched or started states which does not have the HVideoDevice 
reserved shall attempt to reserve it only when the application which created the JMF player calls the 
setVideoTransf ormation method of the control org . dvb .media . 

BackgroundVideoPresentationControl. A JMF player leaving the Started or Prefetched state for the 
Realized state shall release the HVideoDevice if it has it reserved. 

A JMF player which has the HVideoDevice reserved and then loses the right to control that device shall post an 
instance of the event org. davic .media . ResourceWithdrawnEvent to all registered listeners for 
ControllerEvents on that Player instance. If the right to control that device is subsequently recovered when a 
attempt to reserve the device (as defined above) succeeds, then an org . davic . media . 

ResourceReturnedEvent shall be posted. 

1 1 .4.2.8.5 Resource Management Details 

Inter-operable applications shall not call any of the methods on the instance of Resourced lent returned by 

HVideoDevice . get CI lent when a JMF player has reserved that HVideoDevice instance. 

Inter-operable applications are allowed to call HVideoDevice. release or HVideoDevice . setConf iguration 
directly. JMF implementations shall tolerate this behaviour when it happens. 
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11.5 Data Access APIs 

11.5.1 Broadcast Transport Protocol Access API 

The broadcast transport protocol access API is defined in section P, "(normative): Broadcast Transport Protocol Access" 
on page 549. 

Relative file names used to access objects in the carousel shall be taken as being relative to the base directory indicated in 
10.9.2, "DVB-J application location descriptor" on page 98. Calling new DSMCCOb ject ( " . " ) or new Java . io . 
File ( " . " ) will instantiate the directory object that refers to the base directory as indicated in 10.9.2, "DVB-J 
application location descriptor" on page 98. 

The caching rules specified in B.5, "Caching" on page 326 shall be evaluated at the time when the information is loaded 
using DSMCCOb ject . synchronousLoad () or DSMCCOb ject . asyncronousLoad () oris loaded implicitly 
in response to other actions as defined in the following section (11.5.1.1 "Constraints on the Java. io. File methods for 
broadcast carousels"). After the DVB-J object has been loaded, any possible changes in the object carousel to the content 
the object represents are not visible to the application when it accesses the content using this DVB-J object instance. 

11 .5.1 .1 Constraints on the java.io.File methods 
for broadcast carousels 

The application shall be able to use the standard java.io.File class for access to broadcast carousels (e.g. a carousel 
unaware application). In this case, the following definitions shall apply: 

• the constructor of File only creates an instance of the abstract pathname and shall not cause synchronous access to 
the broadcast carousel that would block the thread 

• after the constructor of the DVB-J File object has been run, the directory entry information relating to this object 
may be in an unloaded state. The information relating to this object (e.g. its length) comes from the parent 
directory which is not required to have been loaded at this point by the constructor However, this information 
may be available if the implementation has the information in cache. 

• if the directory entry information for a DVB-J File object is in the unloaded state, then this information shall be 
synchronously loaded when any of the following methods are called on the object: canRead ( ) , exists ( ) , 
isDirectory ( ) , isFile ( ) . If the loading fails, all these methods shall return false. 

• if the content is in unloaded state, it shall be synchronously loaded when the list() method is called for a directory. 
If this implicit load should result in a service transfer, it shall not be done implicitly and the list() shall return an 
empty list. 

• the method lastModified() returns module Version from the DII for the module that carries the file (treating the 
octet as an unsigned integer). 

• any version changes in a file after the constructor for an File Input St ream, FileReader or 
RandomAcce s sF i le is called will not be visible in the data read from that instance. 

• list methods shall return null when called on a object that isn't a directory. 

• the creation of a File Input St ream, FileReader or RandomAccessFile shall throw 
FileNotFoundException if the referenced object is not a file. 

• Failure of a signed file to be authenticated shall be reported as defined in 12.6.1, "General principles" on 
page 164. 

• Failure of a signed directory to be authenticated shall be reported by the list methods returning null when called 
on a file object representing the directory whose authentication failed. 

• The value returned by Java . io . File . length ( ) may not be accurate as it returns the value from the 
directory information rather than the actual size of the file 

There are no guarantees that the most recent version of a file will be returned unless the network signalling specifies that 
the file concerned requires transparent access. 
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1 1 .5.1 .2 Methods dealing with write access 

The Java . io . File class also contains methods that assume write access to the file system. Due to its broadcast 
nature, the receiver naturally does not have write access to the carousel. It should be noted, however, that a broadcast 
carousel is not a read-only file system (which has the property of not changing). The carousel content can certainly be 
written and modified, but only by broadcaster - not the receiver Therefore, the situation is equivalent to a Unix file 
system where the user has only read permissions, but not write permissions or ownership of the files. 

The following Java, io .File methods deal with write access to directories: canWrite () ,mkdir ( ) ,mkdirs ( ) , 
renameXo ( ) . 

For abstract pathname entries in the broadcast carousel, the following behaviour shall apply: 

• canWriteO returns false to indicate that the file can not be written to 

• mkdir(), mkdirs() and renameTo() return false to indicate that the request failed 

1 1 .5.1 .3 Behaviour following loss of a broadcast carousel 

When a broadcast carousel is lost to an application as described in 6.2.5.3, "Loss of Carousel Behaviour" on page 49, the 
following failure modes shall be followed for data which is unavailable. 

• Attempting to load data from a file using a content format specific API shall fail as if the file itself never existed. 
This shall be done according to the specific API concerned. 

• The classloader created by the platform when the application was first launched never attempts to automatically 
recover following loss of its initial broadcast file system. 

• Attempting to load a class which is unavailable shall fail as if the class was never present. 

• After the constructor for an Input St ream has been successfully called, the data for that Input St re am shall 
be maintained by the platform until the Input St ream is closed. This is the same behaviour as specified for 
Input St re am and file version changes in 11.5.1.1, "Constraints on the java.io.File methods for broadcast 
carousels" on page 123. 

• Attempting to create a FilelnputStream for a file whose data is unavailable shall fail with a 

FileNotFoundException. 

• Attempting to create a RandomAccessFile for a file whose data is unavailable shall fail with an 

lOException. 

• Attempting to use a FileDescriptor of a FilelnputStream whose data is unavailable shall result in a 
FilelnputStream or InputStreamReader where all methods shall throw an lOException. 

• Attempting to call methods on a File object whose data is unavailable shall fail in the same way as if the File 
itself never existed. 

• Operations ongoing at the time of loss of broadcast carousel shall be terminated. Blocked Java I/O operations 
shall throw InterruptedlOException. 

1 1 .5.2 Support for Multicast IP over the Broadcast Channel 

Where support for IP over the broadcast channel is included, the following classes and packages shall be supported in 
addition to those listed above for the case where IP support is not included. 

a) The javax.tv.net package as defined in Java TV [5 1] is included. 

b) In Java . net . MulticastSocket, the send method shall throw an lOException when called on sockets 
bound to unidirectional sources of IP multicast data. 

c) In Java . net . DatagramSocket, the send method shall throw an lOException when called on sockets 
bound to unidirectional sources of IP multicast data. 
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d) The following classes from java . net shall be supported:- 

• DatagramPacket 

• SocketException 

• UnknownHostException 

• ProtocolException 

• BindException 

e) The class org.dvb.net .DatagramSocketBuf ferControl shall be supported see Q, "(normative): 
Datagram Socket Buffer Control" on page 615. 

f) Behaviour if unsupported: 

When the application tries to joinGroup() on a Multicast address, ProtocolException shall be thrown to indicate 
failure on joining the group. 

The methods getTTL and setTTL ofjava.net .Mult least Socket are not required to be present. 

1 1 .5.3 Support for IP over the Return Channel 

Where support for IP over the return channel is included, all of the j ava . net package shall be included. Platforms not 
implementing specific optional return channel protocols shall fail as defined in the specification of this API. 

On devices whose return channel can be connected or discormected, coimecting a j ava . net . Socket or a j ava . 
net . URLConnectlon to a host addressed via the return channel shall automatically setup a connection to the default 
connection target subject to the application having return channel permission for the default ISP and the return channel 
either being not connected or being connected to a different target but with the return channel resource reserved by 
another application with a lower priority. Such connections shall be automatically disconnected after a period of 
inactivity on that connection which it should be possible to define using the Navigator. This period shall be returned to 
applications in the "dvb . returnchannel .timeout" system property encoded in seconds as a decimal number. 

See 11.10, "Java permissions" on page 141. 

See also 11.8.1.3, "Other classes" on page 139. 

The constant java . net . HTTPURLConnectlon . HTTP_SERVER_ERROR is not required to be present. 

The class java.net .DatagramSocketlmpl is not required to be present. 

The methods getTTL and setTTL ofjava.net .Mult least Socket are not required to be present. 

In the class java . net . URLStreamHandler, the protected method setURL is not required to be present. 

In the class java.net .URLConnectlon, the static methods getDefaultRequestProperty and 
setDefaultRequestPropertles are not required to be present. 

The class org.dvb.net .DatagramSocketBuf ferControl shall be supported see annex Q, "(normative): 
Datagram Socket Buffer Control" on page 615. 

NOTE: Support multicast of IP over the return channel is not required by 6.3, "Interaction Channel 

Protocols" on page 50. On MHP terminals not supporting this, the methods concerned will fail 
using one of their defined failure modes. 

1 1 .5.4 MPEG-2 Section Filter API 

The MPEG-2 section filter API is defined in annex E of DAVIC 1.4.1p9 [3]. 

1 1 .5.5 Mid-Level Communications API 

See Annex R, "(normative): DVB-J Return Channel Connection Management API" on page 618. 
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On devices whose return channel can be connected or disconnected, when use of j ava . net . Socket or a j ava . 
net . URLConnection automatically sets up a connection, this shall be reported through this API to any applications 
listening for it. 

Implementations shall automatically drop connections established using this API after the same period of inactivity as 
defined for automatically setup connections in 1 1.5.3, "Support for IP over the Return Channel" on page 125. 

If an application which has reserved a Connect ion RC Interface and established a connection then releases the 
resource without disconnecting, the behaviour of the MHP terminal is implementation dependent. 

If there are open sockets using that connection, the MHP terminal should keep the connection established until the time- 
out period defined in 1 1 .5.3, "Support for IP over the Return Channel" on page 125 for automatically setup connections. 

1 1 .5.6 Persistent Storage API 

• The API to persistent storage shall be the j ava . io package and the extensions to it found in the org . dvb . 
io. persistent defined in annex K, "(normative): DVB-J persistent storage API" on page 389. 

• The "dvb .persistent . root " property which can be obtained from Java . lang. System. 
getProperty ( ) identifies the directory at the root of the file name space used for persistent storage. This value 
shall be the same for all applications. 

• Accessing any files or directories in the parent directory of this root or directories above that shall throw a 
SecurityException as defined in the specification for the Java . io package. 

• Signed applications which are authenticated and which are granted the right to access persistent storage have the 
following privileges: 

- read only access to the root directory (defined above) 

- automatic read and write access to an "organisation" sub-directory named <organisation_id> 

- automatic read and write access to an "application" sub-directory 
named <organisation_id> + <file.separator> + <application_id> 

• When the permission request file for an application requests access to persistent storage and this is granted, the 
MHP terminal shall be responsible for creating the necessary directories in which the application is allowed to 
read/write where these do not already exist. This shall be done before the first access (including existence checks 
such as File . isDirectory ( ) ) by that application instance to the directories concerned. 

For applications which are granted file access (see 12.6.2.7, "File Access" on page 171), the necessary directories 
are only its organisation and application sub-directories. For applications which are granted a credential, (see 12. 
6.2.6, "Credentials" on page 168), the necessary directories are those defined by any filename elements in that 
credential up to but not including the first directory containing a wildcard. 

EXAMPLE: A filename element such as 

orgO_id/ appA_id/ externa 1/B_?/- 

creates 

orgO_id/appA_id/ external 

When the MHP terminal automatically creates an "application" sub-directory as part of the necessary directories 
defined above, it shall set the owner of the created sub-directory to the application whose name corresponds to 
that sub-directory and set read and write access to the application whose name corresponds to that sub-directory 
and no access for other applications. The MHP terminal shall set the owner of any additional automatically 
created necessary directories that reside below an "application" sub-directory to the application whose name 
corresponds to that "application" sub-directory and set read and write access to the application whose name 
corresponds to that "application" sub-directory and no access for other applications. 



ETSI 



127 ETSITS 101 812V1.3.1 (2003-06) 



If at the time when an MHP tenninal would create the "appHcation" sub-directory (if it did not exist), that 
directory already exists but is owned by an application other than the one whose application_id is used as its 
name, the MHP terminal shall remove this directory and any contents of it and create an empty "application" sub- 
directory with the owner and access rights set as defined above. 

• The owner of the "organisation" directory shall be the platform and the directory itself shall always have 
organisation read / write and world read access. 

• All files in persistent storage shall store the 48 bit application identifier of their creator as the "owner" of the file. 
Only the owner of the file is entitled to change the file attributes and file access rights. The owner of a file caimot 
be changed once a file is created. 

• Applications may only create files or directories in directories to which they have write access. 

• The existing semantics for the java.io package are respected. 

• See 14.5, "Text encoding of application identifiers" on page 222. The fields <organisation_id> and <application_ 
id> are hexadecimal text encodings (without leading zeros) of the fields in the 48 bit application identifier of the 
application concerned as defined in 10.5, "Application identification" on page 83. 

• All access to persistent storage shall be consistent with the security mechanism defined in 12, "Security" on 
page 151. 

NOTE 1: As defined in 11.5.1, "Broadcast Transport Protocol Access API" on page 123, relative paths caimot 
be used to access persistent storage in an inter-operable way. NOTE 2:Unsigned applications have 
no access to persistent storage. See 12.6.2.7.1, "Unsigned applications" on page 171 

The contents of a file placed in persistent storage shall persist at least until one of the following conditions occur. 

a) There is not enough free persistent storage available to satisfy the persistent storage needs of a ruiming 
application. 

b) The file stored in persistent storage expires. 

c) The file is cleared (i.e. deleted) by the creating application or an application with appropriate permissions. 

d) The file is cleared as a result of an explicit request by the end user. 

e) The persistent storage used by MHP applications exceeds 75% of the value in table G.5, "Minimum requirements 
for other resources for conformance purposes" on page 360 

NOTE: This enables terminal's resource management system to release files as a result of an 
implementation-specific resource management policy. 

The terminal shall give priority to the retention of higher priority files over lower priority files within the scope of a 
specific(organization ID, application ID) pair. See org.dvb. io .persistent . FileAttributes for priorities. 

The details regarding the release of cleared (i.e. deleted) or expired files are implementation dependent. 

The MHP terminal shall have a means to clear at least the quantity of persistent storage defined in table G.5, "Minimum 
requirements for other resources for conformance purposes" on page 360. This mechanism shall be usable in 
conformance tests, and is not subject to the rules above. 

Some MHP terminals may allow a file to be opened for writing by only one FileOutputStream (or other file-writing 
object) at a time. In such situations the constructors in FileOutputStream, RandomAccessFile and 
FileWriter will fail if the file involved is already open. Concurrently running applications writing to the same file(s) 
in persistent storage caimot rely on this mechanism and will need to co-ordinate access to persistent storage themselves. 

1 1 .6 Service Information and Selection APIs 

1 1 .6.1 DVB Service Information API 

The DVB specific SI API is defined in annex M, "(normative): SI Access API" on page 410. 
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1 1 .6.2 Service Selection API 

The service selection API is defined by the javax.tv. service, select ion package fi-om JavaTV [51]. 

On the first occasion when the method ServiceContext . getServiceContentHandlers is called fiar a 
specific service, any JMF players returned shall always be in the started state and if they are presenting video, that video 
shall always be presenting on the background video device. The same JMF player shall be returned fiar all real-time 
media components sharing the same clock. The MHP terminal shall monitor the set of service components being 
presented and update the list of service content handlers to track changes. 

Applications shall re-acquire the list of service content handlers after a service selection completes. It is implementation 
dependent whether any previous handlers are re-used. JMF players which are not re-used are stopped and may be 
disposed by the platform. Where a JMF player is re-used, it shall be reset to a default condition as if it was not being re- 
used. In particular the implementation shall cancel all listeners previously defined and reset any previously defined 
characteristics such as video scaling or positioning. 

The exception javax. tv. services .selection . ServiceContext Except ion shall never be thrown by 
MHP terminals. 

The default media player behaviour following service selection is defined under 1 1.4.2.3, "Default media player 
behaviour" on page 117. 

The protected constructor of ServiceContextFactory is for implementation use. MHP applications shall not 
subclass ServiceContextFactory. Implementations are not required to behave correctly if they should do this. 

Implementations of this API are required to perform tuning as part of implementing the ServiceContext . select 
methods where the new service to be selected is part of a transport stream known to the MHP terminal but not currently 
tuned to. 

All the MHP applications running within the same service context shall have the ability to obtain and modify the state of 
the service component handlers for all service components being presented in that ServiceContext. For service 
component handlers which are JMF players, modifying the state includes changes to the settings of JMF controls in 
addition to the state machine of the JMF player itself. 

Applications not running in that service context (e.g. the MHP navigator) shall not be able to modiiy the state of service 
component handlers unless they first inform the applications in the service context of this. For service component 
handlers which are JMF players, this informing shall be done by sending a org . davic . media . 
ResourceWithdrawnEvent to all applications which have currently registered listeners for ControllerEvents on 
the JMF player whose state will be modified. 

Once a ResourceWithdrawnEvent has been sent, any changes made by applications inside the service context to 
the state of service component handlers will be ignored by the MHP terminal. Methods to query state shall return the 
actual state and methods to change the state shall silently fail. It is implementation dependent whether events related to 
JMF continue to be sent to applications. 

If the application outside the service context ceases to need to make changes to the state of service component handlers, 
the applications inside the service context shall return to having that right exclusively. The applications inside the service 
context shall be informed of the return of this right. For service component handlers which are JMF players, this 
informing shall be done by sending a org . davic . media . ResourceReturnedEvent to all applications which 
have currently registered listeners for ControllerEvents on the JMF player which is returned to exclusive control. 

Following receipt of a ResourceReturnedEvent, the MHP applications running in the service context are 
responsible for returning the configuration of all service component handlers to what they require. The MHP terminal is 
not required to automatically restore any configuration of any service component handler to any former value. In the case 
of a service component handler which is a JMF Player, the configuration is the set of writeable properties accessed 
through the Controls of that Player. 

NOTE: Example properties include video scaling, video positioning and audio language choice. 

NOTE: One situation where this may occur is where the end-user of the MHP terminal brings up the UI of 
the navigator, does some operation and then exits the navigator, returning control back to the MHP 
applications. 
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NOTE: There is no relationship required between the generation of these events and the Xlet state model. 
MHP terminals may chose to put all MHP applications which are in the Active state into the Paused 
state when the bring up the UI of the navigator however there is no requirement for this. 

A running DVB-J application shall be considered as a component of the service being presented in the 
ServiceContext in which the application is running. It shall have a ServiceContentHandler which is 
intentionally not defined by this specification except that it shall not be a ServiceMediaHandler. The results of 
calling the getServiceContentLocators method on this ServiceContentHandler are implementation 
dependent. If the ServiceContext in which a DVB-J application is running is stopped, the DVB-J application shall 
be stopped like all other service components being presented in that service context. ServiceContentHandlers for 
DVB-J applications shall not be shared between DVB-J applications if more than one application is running. 

NOTE: An Xlet is not a javax . tv . service . navigation . ServiceComponent, the elementary 
stream(s) carrying the object carousel carrying the Xlet shall be represented by at least one of these. 

NOTE: Services with only DVB-J applications and no media components will have no 

ServiceMediaHandlers but only ServiceContentHandlers representing the rurming 
DVB-J applications. 

NOTE: This specification intentionally does not define any circumstances under which 

SelectionFailedEvent (MISSING_HANDLER) is required to be generated. 

NOTE: Stopping all the components of a service (both media and Xlets) results in a service with no 
components being presented, the same as if a service with no components had been initially 
selected. 

The following stream types (from javax . tv. service . navigation . StreamType) shall be selectable and shall 
have ServiceContentHandlers defined: AUDIO, VIDEO, SUBTITLES. 

If the selected service is a DVB NVOD reference service, MHP terminals shall make an implementation dependent 
choice from those NVOD time shifted service associated with that reference service and try to select the chosen time 
shifted service. The algorithm for the implementation dependent choice shall be automatic and not involve the end-user. 
Any failure shall be reported as specified through this API. 

NOTE: Applications which wish to chose a specific time shifted service need to explicitly specify that 
service and not rely on the choice of the receiver 

11.6.3 Tuning API 

The tuning API is defined in annex H of DAVIC 1.4. Ip9 [3] apart from section H. 4, (the Locator and DvbLocator 
classes) which are found in section 1 1 .7.6 "Content Referencing". 

The following methods in this package shall throw Java . lang . SecurityException where and only where the 
application does not have a org . dvb . net . tuning . TunerPermission: 

• NetworklnterfaceCont roller . reserve 

• NetworklnterfaceCont roller . reserveFor 

The class org . davic . net . tuning . dvb . DvbNetworklnterf aceSIUtil is not required. 

See also 1 1.8.3, "Additional permissions classes" on page 140. 

Tuning automatically performed by other APIs in MHP shall be reported through the tuning API to any applications 
listening for it. 
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1 1 .6.4 Conditional Access API 

The conditional access API is defined in annex I of DAVIC 1.4. Ip9 [3]. 

The following classes are not supported as defined in section 1 1.2.2 "Approach to Subsetting" - CAlModule, 
CAOModule, CAlMessage, CAOMessage, CAlModuleResponseEvent and CAOModuleResponseEvent. 

Physical CI modules or embedded systems following the CI protocol can produce MMI messages. The API 
implementation, subject to security model, passes those to be presented by the application if the application is interested. 
Otherwise CA dialogs are generated. 

The following methods in this API may throw Java . lang. SecurityException:- 

• CAModuleManager .addMMIListener 

• CAModule . queryEntitlement 

• CAModule . listEntitlements 

• CAModule . buyEntitlement 

• CAModule . openMessageSession 

The sessionlDs used in CI message passing are unique to a single application and access shall fail if shared between 
applications. 

See also 1 1.8.3, "Additional permissions classes" on page 140. 

Host Control tune requests from a CI module cause service selections. Host Control replace / clear_replace has an 
equivalent effect to using javax . tv . media . MediaSelectControl. 

1 1 .6.5 Protocol Independent SI API 

The protocol independent SI API is defined by the following packages from Java TV [51]: 

javax . tv . service 

javax . tv . service . guide 

javax . tv . service . navigation 

javax . tv . service . transport 

The mapping of this onto the DVB-SI protocol is specified in annex O, "(normative): Integration of the JavaTV SI API 
and DVB Sr on page 541. 

Cancellation shall fail if the request is no longer pending. It is implementation dependent if cancellation fails under any 
other circumstances. Implementations are not required to support cancellation of requests between when the requested SI 
data has arrived in the device and when execution of the notif ySuccess method starts. 

The interface javax . tv. service . ServiceMinorNumber is not required to be implemented by any object 
defined in this specification. 
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11.7 Common Infrastructure APIs 

1 1 .7.1 APIs to support DVB-J application lifecycle 

This API is formed of the Java classes and interfaces found in the javax . tv . xlet package specified in 
Java TV [51]. 

11.7.1.1 Xlet properties 

The following named Xlet properties shall be supported: 

• dvb.org. id 

• dvb . app . id 

• dvb . caller .parameters 

They can be retrieved from an Xlet's XletContext by calling getXletProperty with the string name defined above. 

All keys for XletContext . getXletProperty beginning ' dvb . ' are reserved for use in DVB project 
specifications. 

The array of strings returned by XletContext . getXletProperty (XletContext .ARCS) shall be the array of 
strings defined in the DVB-J application descriptor (see 10.9. 1 on page 98) in the same order as specified in the 
signalling. Each entry in the loop of that descriptor shall be presented as one string in the array returned by this method, 
interpreted using the encoding as specified in 10.4.8, "Text encoding in AIT" on page 83. Zero-length strings in the 
signalling shall be represented as the empty string. 

The "dvb.caller.parameters" XletProperty contains the array of Strings that was passed into the AppProxy . 
start ( String [ ] ) method by the application that started this application. If this application was started by the 
system or by another application using the AppProxy . start ( ) method without parameters, an empty array with 
length is returned as the value of this XletProperty. 

Table 42 : Property name / type / encoding mapping 



Property Name 


getXletProperty return type 


dvb.app.id 


String encoded as in 14.5, "Text encoding of application identifiers" on page 222. 


dvb.org. id 


String encoded as in 14.5, "Text encoding of application identifiers" on page 222. 


dvb.caller.parameters 


StringO, no information to be indicated with an array of length zero. 



1 1 .7.1 .2 Actions for DVB-J applications to perform in their 
destroy method 

Xlets shall perform at least the following in their Xlet . destroyXlet method and before calling XletContext . 
notif yDestroyed: 

cause any threads that they have created to exit voluntarily. See "java.lang package" on page 107. 

stop, deallocate and close any JMF players that they have created. 

stop and destroy any JavaTV service selection ServiceContext objects that they created. 

release any other scarce resources that they created, e.g. Networklnterf aceControllers if they do any 
tuning. 

flush any images using the Image . flush ( ) method. 

Xlets shall not cause any unnecessary delay in their Xlet . destroyXlet method. 

de-register any event listeners 
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If applications do not release these resources then the platform may do it for them. 

Regardless of whether an application releases resources or whether the platform does it, the appropriate notifications 
shall be sent to all other MHP applications which are registered to receive these. For resources which are managed by an 
API using the org . davic . resources package, these notifications are specified by that API. For resources which 
are related to JMF players which are ServiceMediaHanders, if the MHP terminal implementation changes the 
configuration of these resources (e.g. to tidy-up), this shall be notified as defined in 1 1.6.2, "Service Selection API" on 
page 128 for "Applications not running in that service context". 

1 1 .7.2 Application discovery and launciiing APIs 

This API is formed of the org. dvb . application package defined in S, "(normative): Application Listing and 
Launching" on page 642. 

The following properties are defined for use with the method AppAttributes . getProperty: 

Table 43 : Application attribute properties 



Property name (note 1) 


Return 


dvb.j. location, base 


Returns String containing base_directory_bytes from DVB-J application 
location descriptor. 


dvb.j . location .cpath .extension 


Returns String[] derived from classpath_extension_bytes of DVB-J 
application location descriptor with each array entry corresponding to a 
pathname entry as defined for classpath_extension_bytes. 


dvb.transport.oc.component.tag 


Returns Integer containing the component_tag from the selector bytes 

of the transport protocol descriptor. 

If more than one transport protocol descriptor is in the AIT for a remote 

application then it is implementation dependent which of them is 

returned. 


NOTE 1 : Property names beginning "dvb." are reserved for future use. 



The following table defines the source of the information which shall be used for methods returning information from 
entries in the application database for an application signalled in an AIT. This version of this specification does not 
require support for applications signalled by any other means. 

Table 44 : Information source for methods on AppAttributes (Sheet 1 of 2) 



Method 


Information source 


getNameO 


One of the names that can be found in the application name descriptor. 


getName(String IS0639code) 


A name of the application from the application name descriptor 
corresponding to the specified language. 


getNamesO 


All of the names for the application which can be found in the application 
name descriptor and their ISO 639 language code. 


getProfilesO 


The set of profiles signalled in the application profile field of the 
application descriptor. 


getPriorityO 


The contents of the application_priority field of the application 
descriptor. 


getVersions(String profile) 


The values version. major, version. minor and version. micro for the 
specified profile from the application descriptor. 


getlsServiceBoundO 


True if the service_bound field in the application descriptor is set to 1 . 
Othenwise false. 


isStartableO 


There is no information source for this method, the return value is 
derived as specified in the method description. For the purpose of the 
method description, remote applications are defined to be those 
signalled as such in the transport protocol descriptor. 


getldentifierO 


The contents of the application_identifier field of the application 
information section. 
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Table 44 : Information source for methods on AppAttributes (Sheet 2 of 2) 



Method 


Information source 


getServiceLocatorO 


An application shall be considered to be transmitted on a remote 
connection only where the application control code in the signalling is 
REMOTE. The locator for a remote application shall encapsulate the 
values found in the selector bytes of the transport protocol descriptor. 


isVisibleO 


True if the visibility field in the application descriptor is set to 11 . False 
otherwise. 



Table 45 : Information source for methods on Applcon 



Method 


Information source 


getLocatorO 


The bytes carried in the application_locator_byte of the application icons 
descriptor appended to either the base directory of the application 
(where the application type from the application information section is 
zero, from the DVB-J application location descriptor) or the physical root 
(where the application type from the application information section is 1 , 
from the DVB-HTML application location descriptor). 


getlconFlagsO 


The icon_flags field of the application_icon_descriptor. 



Applications signalled in an AIT shall be considered to be externally authorised where their only signalling in that AIT is 
by an External application authorisation descriptor. 

1 1 .7.3 Inter-Application communication API 

The javadoc for the org . dvb . io . ixc package is provided in annex Y, "(normative): Inter-application communication 
API" on page 742. An example is provided in W.2, "Example of exporting an object for inter-application 
communication" on page 728. 

This API is formed of the interfaces Java . rmi .Remote and Java . rmi .RemoteException, and the classes 
Java . rmi .NotBoundException and Java . rmi . AlreadyBoundException as specified in JAE 1.1. 
8 API [31], plus the package org . dvb . io . ixc. 

Two named Xlet properties are introduced: dvb . org . id and dvb . app . id. They can be retrieved from an Xlet's 
XletContext by calling getXletProperty ( "dvb . org. id" ) and getXletProperty ( "dvb . app . id" ) , 
respectively. 

1 1 .7.3.1 Remote Call Semantics 

An object may be communicated to another Xlet in two ways: 

• A reference to the remote object can be passed, 

or 

• a copy of the remote object can be made. 

These two techniques are called "pass by remote reference", and "pass by remote copy". When an object that has been 
bound to the IXC Registry via a method of org . dvb . io . ixc . IxcRegistry is imported by another, it shall be 
passed by remote reference. 

1 1 .7.3.1 .1 Objects Passed by Remote Reference 

An object that is passed by remote reference must implement a remote interface. A remote interface is an interface that 
extends, either directly or indirectly, the marker interface j ava . rmi . Remote. The declared type of a parameter or a 
return value for a remote method invocation must be a remote interface, or a class whose instances are serializable. If a 
remote interface that is application-defined, the interface definition must be included in both the sending and receiving 
Xlet. If the two xlets contain an identically named remote interfaces that contain different declarations, the result of 
attempting to use these interfaces for inter-Xlet communication is undefined, and possibly implementation dependent. 
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When an object is passed by remote reference to a different Xlet, the receiving Xlet does not receive a direct reference to 
the exported object; rather, it receives an instance of a stub class. This stub class will not be a subclass of the remote 
object's runtime type; rather, it will be a platform-generated class that implements the remote interface type that is the 
declared type of the argument or return value. It will include implementations of all methods specified by the remote 
interface, and will contain no other members accessible to the application. These methods are called "remote methods." 
Remote methods invoked on this stub class instance will be forwarded to the object in the original Xlet, and executed in 
the context of that Xlet. 

NOTE: The remote methods specified by a remote interface include all methods specified by that interface, 
including the methods inherited from superinterfaces. This applies even for methods inherited from 
superinterfaces that do not themselves extend j ava . rmi . Remote, either directly or indirectly. 

The definition of the stub class shall be automatically created by the platform. 

NOTE: This differs from traditional network RMI, where the stub classes are created by the developer 

using a tool such as rmic. If stub classes produced by rmic or any other off-line tool are present, the 
platform shall silently ignore them for the purposes of inter-Xlet communication. 

The stub class that is generated shall include a definition for all of the methods specified by the declared remote interface 
type. A remote interface is an interface that extends Java . rmi . Remote, either directly or indirectly. These remote 
methods must be declared as follows: 

• Each method must declare Java . rmi . RemoteException in its throws clause, in addition to any 
application-specific exceptions. 

• A remote object passed by remote reference as an argument or return value must be declared as an interface that 
extends j ava . rmi . Remote, and not as an application class that implements this remote interface. 

• The type of each method argument must either be a remote interface, a class or interface that implements Java . 
io . Serializable, or aprimitive type. 

• Each return value must either be a remote interface, a class or interface that implements j ava . io . 

Serializable, aprimitive type, or void. 

If any remote method does not follow these rules, the platform cannot generate a stub class. When one is required, a 
RemoteException shall instead be thrown to the caller. 

11.7.3.1.1.1 Lifecycle Considerations for Remote Objects 

When an Xlet is destroyed, it is possible that other Xlets may have remote references to some of the Xlet's objects. If a 
method is invoked on one of these remote objects, the platform may fail to execute the method, and instead throw a 
RemoteException. If a remote method call is in progress when the Xlet receiving the call is destroyed, the calling 
Xlet may receive a RemoteExcept ion on the calling thread, and the remote method invocation may be abruptly 
terminated. If a remote method has started executing code in the implementation of the remote object when the Xlet 
making the call is destroyed, the call shall run to completion, unless the Xlet receiving the call is also destroyed. 

1 1 .7.3.1 .1 .2 Exceptions in Remote Method Calls 

If an exception is thrown from a remote method, a remote copy of that exception shall be made in the context of the 
calling Xlet. This copy of the exception shall be thrown to the caller. 

11.7.3.1.1.3 Re-exported Objects 

It is possible that an object passed from one Xlet to another might be passed back to the original Xlet. This could happen 
through any number of intervening Xlets. If this happens, the original Xlet will receive the instance that it originally 
exported. If it compares the instance it receives with the original instance using the Java == operator, the result will be 
true. Because of this, there is no need to provide an override of Java . lang . Object . equals ( ) or Java . lang . 
Ob ject .hashCode () for remote objects. 

NOTE: This behaviour is different than network RMI, as implemented in traditional Java implementations. 
In Sun's implementation of network RMI, a remote stub object is given to the original Xlet, but 
stubs and remote objects are required to have a special version of the equals ( ) and 
hashCode methods. 
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1 1 .7.3.1 .2 Objects Passed by Remote Copy 

An object is passed by remote copy when a method argument or return value is passed, where the class of that object does 
not implement j ava . rmi . Remote. Additionally, a remote method call exception is communicated to the receiving 
Xlet by remote copy, as described in 1 1.7.3.1.1.2, "Exceptions in Remote Method Calls" on page 134. 

When an object is passed by remote copy, it is serialized into a byte stream in the context of the exporting Xlet, and 
deserialized in the context of the importing Xlet. Serialization is performed as defined for java.io.Serializable. 
Application-defined classes may be serialized, but the definition of the application-defined class must be present in both 
Xlets, and the external forms of both versions of the class must be compatible. If any error in serialization or de- 
serialization occurs, an instance of Java . rmi . RemoteException shall be thrown. 

1 1 .7.3.1 .2.1 Treatment of Primitive Types 

Primitive types passed as method arguments or return values are copied. 

1 1 .7.3.1 .3 Classloading Considerations 

The presence of inter-xlet communication does not allow the loading of one Xlet's classes from another No classloader 
that loads classes from a remote Xlet for remote method calls is created (unlike network RMI, which creates a special 
RMIClassLoader for remote objects). Rather, a copy of each application-defined remote interface and serializable 
object involved in a remote method invocation must be present in both Xlets. If this is not the case, the platform shall 
generate a RemoteException and throw it in the calling thread. 

11.7.3.1.4 Thread Usage 

A remote method may or may not execute in separate underlying thread. If an application makes a remote method 
invocation to a remote object in a different application, and that second application calls back to the first in the same 
"thread," then the first application might or might not observe that the original calling thread and the callback thread are 
the same instance of Java . lang . Thread. 

If an application makes simultaneous remote calls in separate threads, then the remote execution shall appear to be 
carried out in parallel. 

NOTE: This is not meant to rule out thread-pooling techniques. Specifically, an implementation may 

choose to serialize such remote calls, as long as the first one completes within a reasonably short 
time, relative to the normal scheduling rules of Java threads. 

1 1 .7.3.1 .5 Garbage Collection of Remote Objects 

When a non-destroyed Xlet contains a reachable instance of a stub for a remote object, that remote object shall not be 
garbage collected, unless the remote Xlet is destroyed. When an exported object no longer has any remote stub objects 
that are reachable in other non-destroyed Xlets, and when that exported object is also not reachable locally within its 
Xlet, then that remote object shall be considered unreachable, and thus eligible for reclamation. 

When an Xlet is destroyed, other Xlets may hold remote references to objects within the Xlet being destroyed. In this 
case, the referenced objects may be dereferenced and ultimately garbage collected. If this is done, then attempts to invoke 
remote methods on these objects shall result in a RemoteException to the caller. 
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1 1 .7.4 Basic MPEG Concepts 

This API is formed of the Java classes defined in annex G of DAVIC 1.4.1p9 [3]: 

• ApplicationOrigin, 

• ElementaryStream, 

• Service, 

• TransportStream, 

• DvbElementaryStream, 

• DvbService, 

• DvbXransportStream. 

Methods returning instances of elementary stream, service or transport stream shall return instances of the dvb specific 
subclass (DvbElementaryStream etc.). 

1 1 .7.5 Resource Notification 

The resource notification API is defined in annex F of DAVIC 1.4.Ip9 [3]. 

• The notifyRelease ( ) method shall be called for all ResourceClients where the corresponding 
resource has been removed without the application releasing it. The release ( ) method shall be called for 
specific resources where time to cleanup is of practical use considering the specific resource in question. The only 
one of these in this specification is connection oriented return channels. 

• The requestData parameter of the requestRelease method shall implement the Java . rmi . Remote 
interface. In APIs using the ResourceProxy interface, where the method to reserve the resource has a 
parameter 'requestData', this parameter shall also implement the Java . rmi . Remote interface or be null. 
Use of other values shall result in null being used when requestRelease ( ) is called. Implementing the 
Remote interface does not force java.rmi to be used when the current owner of the resource is in the same 
application as code requesting ownership. 

• The resourceProxy . getClient () method shall always return the ResourceClient provided to the 
platform by the application when that instance of a ResourceProxy was created or reserved. The 
ResourceClient for the current owner of a resource is only returned when this method is called on the 
ResourceProxy which currently holds the resource concerned. 

This text clarifies the DAVIC javadoc with respect to multiple simultaneous applications. Interpretations of the 
DAVIC javadoc which are inconsistent with this are excluded. 

1 1 .7.6 Content Referencing 

This API is formed of the classes found in section H.4 of armex H of DAVIC 1.4. Ip9 [3] - the Locator and 

DvbLocator classes. It also includes the javax.tv. locator package as defined in Java TV [51]. 

The signature of the org . davic . net . Locator class will be extended with: 

"implements javax . tv . locator . Locator" 

The createFactory ( ) method of javax . tv . locator . LocatorFactory shall always return org . davic . 
net .Locator (s) which implement the javax.tv. locator . Locator interface when provided with DVB 
URLs as input (as defined in 14.1, "Namespace mapping (DVB Locator)" on page 218). 

In this specification, methods whose signature has a return type of org . davic . net . Locator or javax . tv . 
locator . Locator shall return an instance of org. davic . net . dvb .DvbLocator (or a platform defined 
subclass of that) where the locator returned can be represented by the DVB locator syntax described in DAVIC 1.4. 
Ip9 [3]. In this case, the DvbLocator returned shall contain the numeric identifiers of a DVB service (see 14.9, "Service 
identification" on page 225). 
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In javax . tv. locator . Locator . toExternalForm ( ) , the canonical form of a DVB locator is defined as 
follows: 

• For instances of org. davic . net . dvb .DvbNetworkBoundLocator, the syntax of this string is 
implementation-dependent. However, the resulting string shall be sufficient to recreate an equivalent locator (e.g. 
using JavaTV's LocatorFactory) at a later time. The same string shall be valid even if stored by the Xlet (e.g. 
in persistent storage) and used at a later time. 

• For instances of org . davic . net . dvb . DvbLocator which are not instances of the above sub-class and 
reference a service or more detailed parts of a service, this shall be the format defined in the MHP specification. If 
the optional transport_stream_id was provided when the instance was built, it shall form part of the external form 
otherwise it shall not. 

• For instances of org . davic . net . dvb . DvbLocator which are not instances of the above sub-class and 
reference only a transport stream but not a service, this shall be the format defined in the MHP specification, 
including the transport stream id. 

NOTE: Because optional extensions (e.g. component tag, event id) are part of the external form, they are 
considered in a comparison thus if they are not equally present in both locators then the comparison 
will fail. 

For the above locators "best effort" comparison shall be exact. 

The protected constructor of LocatorFactory is for implementation use. MHP applications shall not subclass 
LocatorFactory. Implementations are not required to behave correctly if they should do this. 

1 1 11 Common Error Reporting 

This API is formed of the interface and exceptions defined in annex G of DAVIC 1 .4. Ip9 [3]: 

• NotAuthorizedlnterf ace, 

• NotAuthorizedException, 

• Ob jectUnavailableException, 

• ResourceException, 

• TuningException. 
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11.8 Security 

11.8.1 Basic Security 

The following packages and classes as defined in PersonalJAE [36] are supported. 

11.8.1.1 Java. security 



Permissions 

Policy 

Principal 

PrivilegedAction 

PrivilegedActionException 

PrivilegedExceptionAction 

ProtectionDomain 

PublicKey 

SignatureException 

SecurityPermission 

SecureClassLoader (note 1) 

UnresolvedPermission 



From the Java . security package: 
AccessControlContext 
AccessControlException 
AccessCont roller 
AllPermission 
BasicPermission 
CodeSource 

GeneralSecurityException 
Guard 

InvalidKeyException 
Key 

KeyException 

NoSuchAlgorithmException 
NoSuchProviderException 
Permission 

PermissionCol lection 

NOTE 1: The Java . security . SecureClassloader class extends the version of java.lang.ClassLoader, 
defined in JAE 1.1.8 API [31] therefore the java. security. SecureClassLoader class is not required to 
support additional APIs from later versions of java . lang . ciassLoader. It is an allowed implementation 
option for SecureClassLoader to be abstract. 

The MHP platform shall always install a SecurityManager before starting any DVB-J applications. 
The following classes shall be supported: 

Java . security .KeyFactory 

KeyFactory .getlnstance (String algorithm) shall return a valid KeyFactory for algorithm 

"RSA". 

NOTE: since KeyFactorySpi is not required, the protected constructor will be subset out via the 
subsetting rule 

Java . security . spec .Key Spec 

Java .security. spec .EncodedKeySpec 

The EncodedKeySpec constructor is guaranteed to work for X.509 key encodings. 

Java .security . spec .X5 9EncodedKeySpec 

Java . security . spec . InvalidKeySpecException 
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11.8.1.2 java.security.cert 

Certificate 

Cert ificateEncodingExcept ion 
Cert ificateExcept ion 
X509Certificate 
Cert ificateExpiredExcept ion 
Certif icateNotYetValidException 
X509Certificate is not required to implement X509Extensionona compliant MHP terminal. 

11.8.1.3 Other classes 

The following other classes are supported. 

Java . io . FilePermiss ion 
Java . io . SerializablePermiss ion 
Java . lang . Runt imePermiss ion 
Java . util . PropertyPermission 
Java . net . SocketPermission 
Java . awt .AWTPermiss ion 

1 1 .8.2 APIs for return channel security 

This API is defined in the following packages from JSSE [60]: 

• javax.net 

javax . net . ssl 

javax . security . cert 

NOTE: As support for server-side sockets is not mandated by this specification, it is an allowed 

implementation option for the method javax . net . ssl . SSLServerSocketFactory . 
getDef ault ( ) to fail with an appropriate RuntimeException, e.g. 
ClassNotFoundException. 

For the method get Support edCipher Suites in the following classes: 

javax . net . ssl . SSLServerSocket 

javax . net . ssl . SSLSocketFactory 

javax . net . ssl . SSLSocket 

javax . net . ssl . SSLServerSocketFactory 

Cipher suites listed in table 60, "Profile of cipher suites that implementations are required to support" on page 1 87 shall 
have the name found in the "cipher suite" column of that table with "TLS_" replaced by "SSL_". If other cipher suites 
from TLS IETF RFC 2246 [63] are supported, it is implementation dependent whether their names start with "TLS_" or 
"SSL_". 

Also see 12.10, "Security on the return channel" on page 186. 
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1 1 .8.3 Additional permissions classes 

See T, "(normative): Pennissions" on page 679. 

1 1 .8.4 General security issues 

Unless otherwise specified, sub-classes of Java, security .Permission are not required to check the input 
parameters to their constructors. When an MHP platform constructs these, it is responsible for creating them with legal 
values. The behaviour of an MHP platform if an application creates such an instance with illegal values is intentionally 
not specified. 

11.9 Other APIs 

11.9.1 Timer Support 

This API is formed of the Timer API defined in Java TV [51] in the javax . tv.util package. 
Implementations are required to meet the following specifications: 

• Minimum repeat interval less than or equal to 40 ms 

• Granularity less than or equal to 1 0ms 

The only condition defined in this specification where TVTimer . scheduleXimerSpec may throw 
TVTimerScheduleFailedException is if the MHP terminal is unable to provide any more timers. See table G.4, 
"Minimum requirements for other resources" on page 360. 

1 1 .9.2 User Settings and Preferences API 

This API is defined in L "(normative): User Settings and Preferences API". 
The preferences listed below shall be accessible to all applications. 

• User Language 

• Parental Rating 

• Country Code 

• Default Font Size 

Other preferences shall only be accessible where a UserPref erencePermission for "read" has been granted (see 
11.10.2.8, "org.dvb.user.UserPreferencePermission" on page 144). 

1 1 .9.3 Profile and version properties 

Applications can discover the supported profile and the version of the profile (and thus, what functionality is supported) 
by retrieving profile and version properties. If a particular profile is not supported then the related version properties shall 
return null. 

More specifically, the properties listed in table 46 shall be included in the property set of the j ava . lang . System 
class. Thus these properties can be retrieved using java . lang. System, get Property ( ) . Since this API returns a 
string, numeric return values shall be encoded as defined by java. lang. Integer .toSt ring (int) . 

Table 46 : System properties for profile and version interrogation (Sheet 1 of 2) 



Property 


Semantics 


Possible values 


Example 


mhp.profile.enhanced_broadcast 


Indicates whether the enhanced 
broadcast profile is supported 


"YES" 


"YES" 


mhp.profile.interactive_broadcast 


Indicates whether the interactive 
broadcast profile is supported 


"YES", null 


"NO" 


mhp.profile.internet_access 


Indicates whether the internet 
access profile is supported 


"YES", null 


"NO" 
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Table 46 : System properties for profile and version interrogation (Sheet 2 of 2) 



Property 


Semantics 


Possible values 


Example 


mhp.eb. version. major 


Major version number of the 
supported enhanced broadcast 
profile 


Non-negative 
integer value 


"1" 


mhp.eb. version. minor 


Minor version number of the 
supported enhanced broadcast 
profile 


Non-negative 
integer value 


"0" 


mhp.eb. version. micro 


Micro version number of the 
supported enhanced broadcast 
profile 


Non-negative 
integer value 


"0" 


mhp.ib. version. major 


Major version number of the 
supported interactive broadcast 
profile 


Non-negative 
integer value 


"1" 


mhp.lb. version. minor 


Minor version number of the 
supported interactive broadcast 
profile 


Non-negative 
integer value 


"0" 


mhp.ib. version. micro 


Micro version number of the 
supported interactive broadcast 
profile 


Non-negative 
integer value 


"0" 


mhp.ia.version. major 


Major version number of the 
supported internet access profile 


Non-negative 
integer value 


"1" 


mhp.ia. version. minor 


Minor version number of the 
supported internet access profile 


Non-negative 
integer value 


"0" 


mhp.ia.version. micro 


Micro version number of the 
supported internet access profile 


Non-negative 
integer value 


"0" 


NOTE 1 : In previous versions of this specification, "NO" might be returned instead of null for profiles which are not 
supported. 



The properties for querying the version of a profile which is not supported by the MHP terminal shall not be supported. 
Hence, calling System . getProperty ( ) for these properties shall return null. 

1 1 .9.3.1 Information on options 

Chapter 15 defines what is mandatory and optional for each profile. In order to give an application information about 
which options a particular MHP implementation supports, a property string is defined for each option (with the same 
granularity as in chapter 15). 

An MHP implementation supports an option if and only if the corresponding property is known and its value is 
"SUPPORTED". The properties are part of the property set of the java.lang. System class. 

The general syntax of the properties that indicate whether a certain feature is supported or not is: 

mhp . option . <the optional f eature> . 

The table 47 lists the currently defined options. 

Table 47 : System properties for optional feature interrogation 



Option 


Property 


IP Multicast over Broadcast Channel 


mhp.option.lp.multicast 


DSMCC user-to-user over the Interaction channel 


mhp. option. dsmcc.uu 


DVB-HTML 


mhp.option.dvb.html 



11.10 Java permissions 



This section explains how the permissions that are defined to be included in the sandbox that is available to unsigned 
applications and the permissions that can be requested in the permission request file are mapped to the Permission 
objects in the Java platform. 
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11.10.1 Permissions for unsigned applications 

The MHP security policy includes a set of resources that are always guaranteed to be granted to applications, if the 
application is executed. Unsigned applications have access to only these resources. 

This section defines the mapping of those resources to the Java Permission objects. DVB-J applications shall always be 
granted these Permissions. 

11.10.1.1 java.awt.AWTPermission 

This control access to sensitive parts of AWT which is not needed for MHP applications. This shall be denied for both 
unsigned and signed applications. 

11.10.1.2 java.net.SocketPermission: 

Because access to return channel is not within the sandbox, this is not required for unsigned applications. 

11.10.1.3 java.util.PropertyPermission 

For unsigned applications, a read permission shall be granted for all properties defined in this chapter except for those 
explicitly identified as only available for signed applications. The permission shall be denied for the action string "write". 

A read permission may also be granted for other properties except for those explicitly identified as only available for 
signed applications. 

1 1 .10.1 .4 java.lang.RuntimePermission 

This permission shall be denied for both unsigned and signed applications. 

11.10.1.5 java.io.SerializablePermission 

This permission shall be denied for both unsigned and signed applications. 

11.10.1.6 java.io.FilePermission 

A read permission shall be granted for the subtree under which the implementation mounts the object carousels. 

11.10.1.7 javax.tv.media.MediaSelectPermission 

The Media API (i.e. JMF) is within the sandbox, so all applications shall be granted ajavax.tv.media. 
MediaSelectPermission with a locator string "*" that indicates access to all media streams. 

11.10.1.8 javax.tv.service. Read Permission 

Access to Service Information is within the sandbox, so all applications shall be granted a javax.tv.service. 
ReadPermission with a locator string "*" 

1 1 .10.1 .9 javax.tv.service.selection.ServiceContextPermission 

All applications shall be granted a javax.tv. service . selection. ServiceContextPermission with a 
name string "getServiceContentHandlers" and action string "own". 

ServiceContextPermission ( "access", "own" ) shall be granted to all MHP applications. 
ServiceContextPermission ( "access", "*" ) shall not be granted. 

11.10.1.10 java.util.Locale.setDefault 

This method shall throw a security exception. 
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1 1 .1 0.2 Additional Permissions for signed applications 

Signed applications can additionally request to get more permissions. These permissions are requested using the 
permission request file (12.6, "Security policy for applications" on page 164). This section defines the mapping from the 
items in the permission request file to the Java Permissions that may be granted by the MHP terminal in response to the 
request. 

11.10.2.1 java.util.PropertyPermission 

For signed applications, a read permission shall be granted for all properties for unsigned applications and dvb . 

persistent . root. 

11.10.2.2 java.io.FliePermission 

A read permission shall be granted for the subtree under which the implementation mounts the object carousels. 

When the permission request file requests the permission to access persistent storage and this is granted, a 
FilePermission that permits access to the persistent storage directory subtree is created. 

NOTE: The FilePermission created shall comply with the access rights defined in section 12.6.2.7.2, 
"Policy for signed applications" on page 171. 

When there is a persistent file credential in the permission request file and this is granted, FilePermissions are 
created as follows: 

• file path = value of dvb .persistent, root property + filename from the credential 

• action = string containing "read" if "read" is indicated in the credential; or string containing "write, delete" if 
"write" is indicated in the credential" 

NOTE: A single instance of FilePermission is not sufficient to express the limitations on accessing 
files & directories through credentials required by section 12.6.2.6, "Credentials" on page 168. 
Implementations are responsible for enforcing those requirements and cannot rely on a single 
instance of FilePermission to achieve this. 

1 1 .10.2.3 org.dvb.net.ca.CAPermission 

When the permission request file requests the permission to communicate with a CA system and this is granted, a 

CAPermission is created as follows: 

The CA system ID string from the permission request file is directly used as the first part of the string used for the 
CApermission constructor, this is concatenated with a colon character and the list of the attribute strings based on the 
attributes listed as true in the permission request file. 

1 1 .10.2.4 org.dvb.application.AppsControlPermission 

When the permission request file requests the permission to have additional permissions to control the lifecycle of 
applications and this is granted, an AppsControlPermission is created. 

1 1 .10.2.5 org.dvb.net.rc.RCPermission 

When the permission request file requests the permission to communicate through the return channel and this is granted, 
an RCPermission is created as follows: 

• for the default ISP item, the RCPermission is created with "target:default" string. 

• for items with phone numbers in them, the string is "target:" + the phone number prefix in the permission request 
file + "*" 

On org . dvb . net . re . ConnectionRCInterf ace, the method getCurrentTarget shall always throw a 
SecurityException. The method setTarget shall throw a security exception where the application doesn't have 
the permission to use the target specified. The method setTargetToDef ault shall throw a security exception where 
the application doesn't have either "target:default" or "target:*" permissions. 
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11.10.2.6 org.dvb.net.tuning.TunerPermission 

When the permission request file requests the permission to access the Tuning API and this is granted, an 

TunerPermission is created. 

1 1 .10.2.7 javax.tv.service.selection.SelectPermission 

By default a SelectPermission is created with a locator "*" and action string "own" and a 

ServiceContextPermission is created with a name "*" and action string "own", unless denied by an entry in the 
permission request file. 

11.10.2.8 org.dvb.user.UserPreferencePermission 

When the permission request file requests the permission to read and/or write user preferences and this is granted, a 

UserPref erencePermission is created as follows: 

• when the permission request file includes "true" for the "read" attribute and this is granted, a 
UserPref erencePermission is created with the string "read" 

• when the permission request file includes "true" for the "write" attribute and this is granted, a 
UserPref erencePermission is created with the string "write" 

1 1 .10.2.9 java.net.SocketPermission 

When the permission request file requests the permission to communicate with remote hosts and this is granted, 
SocketPermi s s ions are created with the host and action as indicated in the permission request file. 

These permissions shall not be granted in MHP terminals where all return channels are represented by instances of org . 
dvb . net . re . ConnectionRCInterf ace (i.e. where all return channels are connection oriented) unless an 
instance of org. dvb . net . re .RCPermission is also granted. 

11.10.2.10 org.dvb.media.DripFeedPermission 

When the permission request file requests the permission to use the drip feed feature and this is granted, a 
DripFeedPermission shall be created. 



11.11 Content referencing 



The following mapping shall be used between the types of locator defined in table 64, "Addressable entities, locators and 
their text representation" on page 224 and the DVB-J methods defined in this chapter. It lists the Java methods & 
constructors which accept or return (as defined by their method signature) instances of org . davic . net . Locator, 
javax .tv. locator. Locator, javax .media .MediaLocat or or their sub-classes. The external form of these 
locators shall be the text representation defined in the table 64, "Addressable entities, locators and their text 
representation" on page 224 for the corresponding entity being referenced. Where the same method is listed as accepting 
multiple forms of locator, then it is required to accept all forms listed in this section. 

Where a method listed below is defined (in its specification) to check its input then it shall only accept the forms of 
locator listed below as being valid for that method from among those defined in this specification. Other forms of locator 
from among those defined in this specification shall be rejected as specified for the method concerned. If a method does 
not specify a means of rejecting inappropriate locators then it shall fail silently apart from Exceptions and Events which 
do not check their input and where it is the responsibility of the platform to use correct locators when constructing them. 
This specification does not prevent methods accepting other forms of locator which are not defined in this specification. 

The sections below apply equally to locators including and not including the network_id. 
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11.11.1 Transport stream 

The following methods used in this specification shall accept or return instances of Objects which describe an MPEG 
transport stream. Methods which accept a locator for a transport stream as an input parameter shall also accept all other 
DVB locators which include the information to identify a transport stream. If present, service_id, component_tag, event_ 
id and path_segments shall be retained but not used except where there is both a method that accepts such a locator and a 
query method specified to return that input. In this case the specified semantics of the query method shall be respected. 

javax . tv . service .transport . Transport St re am. get Locator ( ) 

javax . tv . service .transport . Tr an spo rt St reamCol lection . 
retrieveTransportStream ( ) 

NOTE: This requirement holds only if the terminal supports TransportStreamCollection objects. 

org . davic . net . tuning . StreamXable . get Transport St reams ( ) 

org . davic . net . tuning . NetworklnterfaceCont roller . tune ( ) 

org . davic . net . tuning . Networklnterf ace . get Locator ( ) 

org . davic . net . tuning . Networklnterf aceCont roller . reserveFor ( ) 

org . davic . net . tuning . StreamXable . list Transport St reams ( ) 

org . dvb . si . SI Transport St re am. getDvbLocator ( ) 

NOTE: The numeric identifiers in the locator are matched in the DVB-SI tables as defined in see 14.1.5, 
"dvb_entity = dvb_transport_stream" on page 219. 

11.11.2 Network 

The following methods used in this specification shall accept or return instances of Objects which describe a DVB 
network. 

javax . tv . service . transport . NetworkCol lection . ret rieveNet work ( ) 

javax . tv . service . transport . Network . get Locator ( ) 

11.11.3 Bouquet 

The following methods used in this specification shall accept or return instances of Objects which describe a DVB 
bouquet. 

javax . tv . service . transport . Bouquet Col lection . retrieveBouquet ( ) 

javax .tv. service .transport .Bouquet . get Locator ( ) 



ETSI 



146 ETSITS 101 812V1.3.1 (2003-06) 

11.11.4 Service 

11 .11 .4.1 MPEG/DVB specific service 

The following methods used in this specification shall accept or return instances of Objects which describe a DVB 
service. Methods which accept a locator for a MPEG/DVB service as an input parameter shall also accept all other DVB 
locators which include the information to identify a service. If present, component_tag, event_id and path_segments shall 
be retained but not used except where there is both a method that accepts such a locator and a query method specified to 
return that input. In this case the specified semantics of the query method shall be respected. 

• org . davic . net . ca . CAModule . buyEntitlement ( ) 

• org . davic . net . ca . CAModule . queryEntitlement ( ) 
org . dvb . si . SIDat abase . retrieve SI Service ( ) 
org . dvb . si . SIDat abase . retrievePMTService ( ) 

• org. dvb . dsmcc . DSMCCStream. get St re amLo cat or where the method isMPEGProgr am returns 
true 

• org . dvb . dsmcc . ServiceDomain . attach ( ) 
org . dvb . dsmcc . ServiceDomain . getLocator ( ) 
org . dvb . si . PMTService . getDvbLocator ( ) 

• org . dvb . si . SIBouquet . getSIServiceLocators ( ) 

• org . dvb .si.SIService. getDvbLocator ( ) 

• org . davic . net . ca . TuneRequestEvent - constructor 
org . davic . net . ca . TuneRequestEvent . getLocator ( ) 

• org. dvb . application .AppAt tributes . getServiceLocator ( ) where the service is a MPEG/ 
DVB service 

• org. dvb . dsmcc . ServiceXFRRef erence - constructor where the service is a MPEG/ DVB service 

• org. dvb . dsmcc . ServiceXFRRef erence . getLocator ( ) - where the service is a MPEG/ DVB 
service 

NOTE: The numeric identifiers in the locator are matched in the DVB-SI tables as defined in see 14.1.1, 
"dvb_entity = dvb_service" on page 218. 
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11.11.4.2 Generic Service 

The following methods used in this specification shall accept or return instances of Objects which reference generic 
services. These methods are also required to accept or return the same locators as in the previous section. 

• javax . tv . service . navigation . LocatorFilter - constructor 

javax . tv . service . navigation .LocatorFilter. getFilterValue ( ) 

javax . tv . service . SIManager . get Service ( ) 

javax . tv . service . navigation . ServiceDetails . get Locator ( ) 

javax .tv. service . Service . get Locator ( ) 

javax . tv . service . SIManager . ret rieveServiceDet ails ( ) 

javax . tv . service . navigation .ServiceList. f indService ( ) 

• org. dvb . application .AppAt tributes . getServiceLocator ( ) - where the service is not a 
MPEG / DVB specific one 

• org . dvb . dsmcc . ServiceXFRRef erence - constructor where the service is not a MPEG / DVB specific 
one 

• org. dvb . dsmcc . ServiceXFRRef erence . getLocator ( ) where the service is not a MPEG /DVB 
specific one 

• org . dvb . dsmcc . ServiceXFRException - constructor 

• org . davic .media .MediaLocator -constructor 

• javax .media .MediaLocator -constructor 

javax .media .Manager . create? layer (MediaLocator) 
javax .media .Manager . createDataSource (MediaLocator) 

• Constructor of various JMF events consumes JMF MediaLocators: 

org . dvb .media . CAStopEvent , org . dvb .media . PresentationChangedEvent , org . dvb . 
media . ServiceRemovedEvent , org . dvb .media . NoComponentSelectedEvent 

• Various JMF events return JMF MediaLocators which were passed into their constructors: 

org . dvb .media . CAStopEvent, org . dvb .media . PresentationChangedEvent, org . dvb . 
media . ServiceRemovedEvent, org . dvb .media . NoComponentSelectedEvent 

11.11.5 DVB Event 

The following methods used in this specification shall accept or return instances of Objects which describe a DVB event. 

javax . tv . service . guide . ProgramEvent . getLocator ( ) 

javax . tv . service . SIManager . retrieveProgramEvent ( ) 

org . davic . net . ca . CAModule . buyEntitlement ( ) 

org . davic . net . ca . CAModule . queryEntitlement ( ) 

javax . tv . service . guide . ProgramSchedule . retrieveProgramEvent ( ) 

org . dvb . si . SIEvent . getDvbLocator ( ) 
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11.11.6 MPEG elementary stream 

The following methods used in this specification shall accept or return instances of Objects which describe a MPEG 
elementary stream. Methods below which accept as an input parameter an array of locators shall also accept DVB 
locators including multiple component tags. 

javax . tv . net . Interf aceMap . getLocalAddress ( ) 

• javax . tv . service . selection . InvalidServiceComponentException - constructor 

• javax . tv . media . MediaSelectControl - all methods accepting or returning instances of javax.tv. 
locator.Locator 

• javax .tv. media .MediaSelectEvent & subclasses - constructor 

• javax . tv .media .MediaSelectPermission - constructor 
javax .tv. service. select ion. ServiceContext.select() 
org . dvb .si. SID at abase. ret rievePMTElementary St reams ( ) 
org . dvb . si . PMTElementaryStream. getDvbLocator ( ) 

• org . dvb . dsmcc . ServiceDomain . attach ( ) 

• org . dvb . dsmcc . ServiceDomain . get Locator ( ) 

javax . tv .media .MediaSelectControl . get Cur rent Select ion ( ) 
javax . tv . service . navigation . ServiceComponent . get Locator ( ) 

• javax .tv. media .MediaSelectEvent . get Select ion ( ) (also subclasses) 

• org . davic . net . ca . DescramblingStoppedEvent . getServiceLocator ( ) 
org . davic . net . ca . DescramblingSt art edE vent . getServiceLocator ( ) 

• org . davic . media . MediaLocator - constructor - shall also accept multiple component tag "dvb:" locator 

• javax .media .MediaLocator - constructor - shall also accept multiple component tag "dvb:" locator 

• javax .media .manager . createPlayer ( MediaLocator ) - shall also accept multiple component 
tag "dvb:" locator 

javax .tv. service . selection . I nvalidServiceComponent Except ion . 
getlnvalidServiceComponent () 

javax .tv. service . selection . ServiceContent Handler . 
getServiceContentLocators () 

NOTE: The numeric identifiers in the locator are matched in the DVB-SI tables as defined in see 14.1 .2, 
"dvb_entity = dvb_service_component" on page 219. 
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11.11.7 File 

The following methods used in this specification shall accept or return locators which reference files. 

• org . davic . media . MediaLocator -constructor - for audio files intended to be played from memory 

• javax .media .MediaLocator - constructor- for audio files intended to be played from memory 

• javax .media .Manager . create? layer (MediaLocator) - for audio files intended to be played from 
memory 

javax .media . Manager . createDataSource (MediaLocator ) - for audio files intended to be played 
from memory 

• org.dvb.dsmcc. ServiceDomain . getURL (Locator) - instances of "dvb:" locator including dvb_ 
abs_path 

Apart from the above, all file references shall be encapsulated in instances of java.net.URL. 

11.11.8 Directory 

The following method shall return an instance of the "dvb:" locator referencing a directory. 

org . dvb . application . Applcon . get Locator ( ) 

11.11.9 Drip feed decoder 

The following methods used in this specification shall accept or return locators which reference the "drip feed" decoder. 

• javax .media .MediaLocator - constructor 

javax .media .Manager . createDataSource (MediaLocator) 

11. 11. 10 Irrelevant 

The following methods used in this specification which accept Locators according to their signature have no requirement 
to have locator tj^es specified for them in this specification: 

• javax. tv.service.ReadPermission, all applications shall have this permission with "*", see 11.10.1.8, "javax.tv. 
service. ReadPermission" on page 142. 

• javax. tv.service.selection.SelectPermission, applications shall either have this permission with "*" or not to have it 
at all, see 11.10.2.7, "javax. tv.service.selection.SelectPermission" on page 144. 

11.11.11 Methods working on many Locator types 

The following methods used in this specification work on many locator types. The locator types which each method is 
required to support are listed for each of the methods concerned. 

• javax. tv.locator.LocatorFactory.transformLocator - transforms a transport independent locator into a transport 
dependent one 

required to accept instances of org.davic.net. dvb.DvbLocator 

required to return instances of org.davic.net.dvb.DvbNetworkBoundLocator 

• javax. tv.locator.LocatorFactory.createLocator - creates a locator from a string 

required to accept valid 'dvb' URLs (see 14.1, "Namespace mapping (DVB Locator)" on page 218) and return 
corresponding instances of org. davic.net. dvb.DVB Locator 

• javax.tv. service. SIManager.registerlnterest - accepts a locator referencing one or more SIElements as input 

• javax. tv.service.SIManager.retrieveSIElement - accepts a locator referencing one or more SIElements as input 
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Both these methods are required to accept locators referencing:-Bouquet, Network, Event, ElementaryStream, 
Service, TransportStream 

• j avax.tv. service. SIElement.getLocator 

returns a locator for "this SIElement" as specified by the JavaTV specified sub-interfaces, no other SIElements 
exist 

11. 11. 12 Support for the HTTP protocol in DVB-J 

Where the HTTP (see 6.3.7.1, "HTTP 1.1" on page 51) protocol is supported, the following classes and methods shall 
support HTTP URLs as described below. 

• The constructor for javax.media.MediaLocator - for referencing audio files intended to be played from memory 

• methods on javax.media.Manager accepting javax.media.MediaLocator as input parameters - for constructing 
JMF players for audio files intended to be played from memory 

• The classes & methods in the "java.net" package 

• Methods in this specification which accept instances of java.net. URL are required to accept instances which 
encapsulate an "http" URL and behave according to their specification. - e.g. Toolkit. getImage(java.net.URL) 

When HTTP URLs are used with instances of DVBClassLoader to load DVB-J classes over the interaction channel in a 
signed application, the requirements of the MHP security model shall be complied with before a class is allowed to be 
successfully loaded from such a URL. 
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12 Security 

12.1 Introduction 

This section covers the following areas of security: 

• Authentication of applications 

• Security policies for applications 

• Authentication and privacy of the return channel communications 

• Certificate management 

12.1 .1 Overview of the security frameworl< for applications 

The security framework enables a receiver to authenticate the source of application code or other files. In the case of 
application code files, the authentication advises the receiver what access rights should be granted to an application for 
sensitive resources, see 12.6, "Security policy for applications" on page 164 for more detail. 

The system uses 3 different security messages: 

• Cryptographic hash codes 

This provides a summary of a quantity of data - typically a subset of the total set of data under consideration. 

• Signatures 

These deliver a master hash code (computed over all of the appropriate data) that has been "signed" by an 
authorising organisation. The signing process securely associates the master hash code with the signatory. The 
hash code process shows that the data has not been tampered with since it was signed by the signatory. 

• Certificates 

These provide a "chain of trust" from the authorising organisation up to some trusted third party (the root 
certificate authority) that is well known to the receiver. 

The messages are delivered within files of the file system so this authentication scheme is applicable to any hierarchical 
file system whether operating over the broadcast or return channels. 

Applications that are signed shall be identified with an application_id from the signed applications range (see table 12, 
"Value ranges for application_id" on page 84). Applications that are unsigned shall be identified with an application_id 
from the unsigned applications range. An application with an application_id from the signed applications range but that 
is not signed is considered to have failed authentication. An application with an application_id from the unsigned 
applications range is treated as unsigned even if the files might be transmitted with signatures. 

12.1 .2 Overview of return ciiannel security 

In this version of the specification general purpose protocols and a standard cryptographic suite derived from internet 
standards are used. 

12.2 Authentication of applications 

12.2.1 Overview of autiientication messages 

Three different message types are used: "Hash codes", "Signatures" & "Certificates". Each message is placed in a file. 
The placement of the files depends on their function and is specified under the appropriate headings under 12.4, "Detail 
of application authentication messages" on page 1 54. 
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12.2.1.1 Hash codes 

This specification describes application of hash codes to the following types of information: 

• Files 

• Directories 

The hash computation considers the content and attributes of the objects rather than transport specific information. As a 
result, the authentication is independent of the underlying transport protocol. 

In the case of a directory the hash value depends on the hash values of the objects bound to it, and so provides a hash of 
all of the objects to be authenticated in the "tree" below it. 

12.2.1.2 Signatures 

The data authenticated is a hierarchical file system (for example DSM-CC OC). The root of an authenticated "tree" 
carries one or more signatures. This allows one or more organisations to sign a set of information. 

The root of the authenticated "tree" can be the root directory of the file system or the "top" directory of a "subtree". 

The signature: 

• references a certificate containing the public key required to decode the signature 

• identifies the hash algorithm used 

• and the value of the signature 
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12.2.1.3 



Certificates 



The certificate provides a public key that can be used to decode a hash code contained in a signature and so enable a 
tree/subtree to be verified. The certificate itself is signed by a higher certification authority. 

To correctly authenticate a subtree there must be a valid "chain" of certificates from the signature to a root certificate as is 
illustrated in figure 14. 



Root certificate 



Possible additional 
intermediate certificates 



issuer 
subject 



) 



r — — — n 
, issuer 

subject 
<l I 



Leaf certificate ^ 



issuer 

subject = { 

Common Name, 
Country Name, 
Organization Name, 



Organization Name = text + " . "+ organisation_id 



Signature 



certif icateldentif ier = { 
author ityCert Issuer, 
author ityCertSerialNumber 



authorityCertlssuer 
Common Name, 
Country Name, 



{ 



Figure 14 : Certificate chain illustrated 

12.2.1.4 Autlientication of liierarcliicai file systems 

The solution here is based on authentication of a hierarchical structure of objects. Hashcodes are computed 
systematically and accumulatively across some or all of the objects in the hierarchy. A signature at the top of the 
hierarchy identifies the source of the objects. 

The framework provides a flexible and non-time consuming method enabling the authentication of subtrees of a file 
system with a single signature. Since checking signature is far more time-consuming than checking hashcode values, this 
mechanism is more efficient than signing each object of a subtree. 

Further, only the objects that are loaded need real-time hashcode checking. 

This mechanism does NOT mandate that the whole subtree is authenticated. 

NOTE: The broadcaster can choose which files in the file system are authenticated. For example code files 
might be authenticated and asset files might be left without authentication. 

Finally, this framework embraces key distribution by specifying a certificate mechanism, the aim of this is to certify that 
the key used to compute the signature is valid and used by a certified service provider. See 12.8, "MHP certification 
procedures" on page 179. 
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12.3 Message transport 

The security messages are transported in files. 

In no cases shall a service transfer be required to access the file content. In the case that the file system is an object 
carousel this means that the lOR for the security files shall always use a BIOP profile body and never a Lite options 
profile body. 

12.4 Detail of application authentication messages 

Three data structures are defined for communicating authentication information: 

• "HashFile" on page 1 54 

• "SignatureFile" onpage 157 

• "CertificateFile" onpage 159 

These are placed in files in the file system. The location of the file depends on its function. 

12.4.1 HashFile 



12.4.1.1 



Description 



The HashFile lists all of the elements of the current directory except itself. On transport protocols supporting the listing 
of files in a directory (e.g. Object Carousel), signature files shall not be listed. On transport protocols not supporting the 
listing of files in a directory (e.g. HTTP), signature files shall be listed and shall have a digest_type of non-authenticated. 
Those elements to be authenticated are associated with hashcodes. The syntax of the HashFile is shown in table 48. 

Table 48 : Syntax of the Hashfile 



Syntax 



Hashfile () ( 
digest_count 

for( i=0; i<digest_count; i++ ) { 
digest_type 
name_count 

f or { j=0; j<name_count ; j++ ) { 
name_length 
f or ( k=0; k<name_length; k++ ) { 

name_byte 
} 
} 

for ( j=0; j<digest_length; j++ ) { 
digest_byte 



Num. Bits 



16 



16 



Format 



uimsbf 

uimsbf 
uimsbf 

uimsbf 

bslbf 



bslbf 



Other data may follow but can be ignored by implementations conforming to this profile. 



digest_count: This 16 bit value identifies the number of digest values in this hash file. 
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digest. type: This 8 bit value identifies the digest computation rules and the digest algorithm, if any, used for the 
associated objects. Table 49 lists the allowed values for this field. The digest computation rules are defined in 12.4.1.3, 
"Digest value computation rules" on page 155. 

Table 49 : Values of digest. type 



value 


digest len. 


algorithm 








Non authenticated 


1 


16 


Digest computation rules without prefix and with MD-5 
as defined in IETF RFC 1321 [38] 


2 


20 


Digest computation rules without prefix and with SHA- 
1 as defined in FIPS-180-1 [62] 


3 


20 


Digest computation rules with prefix and with SHA-1 
as defined in FIPS-180-1 [62]. 


Other values 




Reserved for future use 



name_count: This 16 bit value identifies the number of object names associated with the digest value. The value of this 
field shall be greater than zero. 

name_length: This 8 bit value identifies the number of bytes in the object name. 

name_byte: This 8 bit value holds one byte of the object name. 

Each name shall be the name of an object in the directory that contains the HashFile. So, file names are the names of files 
in the directory and directory names are the names of direct sub-directories of the directory. No path information shall be 
included in the name. 

The names carried by this field are binary identical to the payload part of names in the file system. So, any name 
matching process can be binary and ignorant of character encoding, letter case etc. Also, terminating null characters are 
not considered to be part of the file name. 

digest_length: This integer value gives the number of bytes in each digest value. It depends upon the digest type as 
tabulated in table 49. MHP terminals shall support all digest algorithms. 

NOTE: Non-authenticated objects have a zero length digest. 

digest_byte: This 8 bit value holds one byte of the digest value. See 12.4.1.3, "Digest value computation rules" on 
page 155. 

12.4.1.2 HashFile location and naming conventions 

An application comprises files containing data that can be spread across various directories and is contained within a 
subtree of the file hierarchy. A HashFile will be put in each directory containing objects that need to be authenticated. 

The name of the HashFile shall be: 

"dvb .hashfile" 

There shall only be one instance of HashFile per directory that contains authenticated resources. 
See 12.7, "Example of creating an application that can be authenticated" on page 176. 

12.4.1.3 Digest value computation rules 

The digest value is computed over the objects named in the HashFile in the order listed in the HashFile. The length of the 
list of objects associated with each digest value may be one or more. 
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Each list of objects may contain an arbitrary mix of different object types (e.g. a mixture of file and directory names). The 
digest value is computed by first initialising the digest algorithm in an algorithm specific way and then applying the 
relevant data for each object to the algorithm in order. The relevant data for each object depends on its type (File or 
Directory) and on the value of digest_type and is specified in table 50. 

Table 50 : Data required for digest value computation 



Object type 


Digest type 


entry_type 


Relevant data 


File 


1 or 2 


not applicable 


The entire content of the file 


Directory 


The content of the HashFile of the named directory 


File 


3 


1 


A prefix concatenated with the entire content of the 

file. 

The prefix is made of the entry_type encoded as a 32 

bit uimsbf and concatenated with the file length in 

bytes encoded as a 32 bit uimsbf 


Directory 





A prefix concatenated with the content of the HashFile 
of the named directory. 

The prefix is made of the entry_type encoded as a 32 
bit uimsbf and concatenated with the file length in 
bytes encoded as a 32 bit uimsbf 


NOTE 1 : All other values of entry type are reserved for future use 



12.4.1.3.1 



Example 



Consider two files f ilel and f ile2 and one directory dirl. Using digest type 3, the digest value of f ilel + 
file2 +dirl is equal to: 

SHA-l ( (uimsbf 32) 1 + (uimsbf 32) FileLength ( filel) + contents of filel 
+ (uimsbf 32) 1 + (uimsbf 32) FileLength (file2) + contents of file2 
+ (uimsbf 32) + (uimsbf 32) FileLength (HashFile (dirl) ) 
+ contents of HashFile (dirl) ) . 

12.4.1.4 Warning concerning grouping of objects under a single digest (Informative) 

Broadcasters should be made aware that during the construction of the object carousel, grouping objects under one digest 
can significantly and adversely affect the performance and memory requirements of an application on a terminal. For 
example, if 3 objects are grouped under the same digest, implementations must load all 3 objects even if only one is 
needed. 

This specification in general recommends that while setting up a signed application for broadcast, only one digest be 
associated with each object requiring authentication. Grouping of multiple files under one hash value should only be 
employed if those files must always be loaded together and simultaneously. Additionally, the rate of change of the 
contents of an object should be carefully considered because grouping a rapidly changing object with more slowly 
changing objects for the purposes of hashing will negatively impact performance. When attempting such grouping, the 
resource limits of the MHP terminal should always be carefully considered. 
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12.4.1.5 Special authentication rules 

a) For objects which are directories, if the digest_type is non-zero there shall be a HashFile in the sub-directory 
listed. If the HashFile is absent then the authentication fails. 

b) Each HashFile shall provide a complete list of all the objects named in the directory except itself and any possible 
signature files mentioning each name exactly one time. The behaviour varies depending on the ability of the 
transport protocol to support directory listing. 

- On transport protocols supporting the listing of files in a directory (e.g. Object Carousel), the authentication shall 
fail if the set of objects listed in the HashFile is different to the set of objects in the directory. 

- On transport protocols that don't support the listing of files in a directory (e.g. HTTP), the set of names in the 
HashFile acts as a filter for the set of objects that can be accessed. Attempts to access a file neither named in the 
HashFile nor the HashFile itself, nor the signature files shall fail (that is behave as if the file is not available). 

These rules apply regardless of the value of digest_type associated with the object. 

c) If the digest_count is equal to 0, the file HashFile shall be ignored. Every entry in the directory will be non 
authenticated. 

d) If a name_length is equal to zero (or if a name is not found in the directory containing the HashFile), all the names 
associated with the current digest value shall be considered as incorrectly authenticated. It means the 
authentication checking will fail for these entries. 

e) If the object is a Stream or StreamEvent then the digest_type shall be zero. 

f) Objects associated with a digest_type that the receiver does not support shall be treated by that receiver as if the 
value of digest_type was zero (not authenticated). 

g) There is no requirement for certificates files to have a digest_type other than zero (not authenticated). However, if 
they do have a non-zero digest_type they don't receive exceptional treatment. 

NOTE: There is no security benefit in including a certificate file with a digest_type other than zero. 

h) When a permission request file exists, its entry in the HashFile cannot have a digest type of 0. MHP terminals 
shall ignore a permission request file with a digest type of 0. 

12.4.2 SignatureFile 
12.4.2.1 Description 

The SignatureFile is a File containing one digital signature. It contains the following ASN. 1 DER structure: 



Signature ::= SEQUENCE { 
certif icateldentif ier 
hashSignatureAlgorithm 
signatureValue 



Author ityKey Identifier, 
OBJECT IDENTIFIER, 

BIT STRING } 



certificateldentifier : As defined in the ITU-T X.509 [54] extension for the AuthorityKeyldentifier field. It identifies 
the certificate that carries the certified public key that is used to check the signature. 



AuthorityKeyldentifier ::= SEQUENCE { 
keyldentifier 
authorityCertlssuer 
authorityCertSerialNumber 



[0] Keyldentifier OPTIONAL, 

[1] GeneralNames OPTIONAL, 

[2] Certif icateSerialNumber OPTIONAL 



Implementations are not required to use the possibly present keyldentifier element of the 

AuthorityKeyldentifier. The AuthorityKeyldentifier structure shall contain both the 
authorityCertlssuer and authorityCertSerialNumber elements. 

The authorityCertlssuer shall contain the field "directoryName", this field shall be equal to the 
issuerName of the certificate that carries the public key used to check the signature. 

hashSignatureAlgorithm: this field identifies the hash algorithm that is used. Note that the encryption algorithm used 
to compute the signature is already described in the SubjectKeylnfo field of the certificate that certifies this key, and thus 
that only the identification of the hash algorithm is needed. The supported algorithms are MD5 and SHA-1. 
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md5 OBJECT IDENTIFIER ::= 

{ iso(l) member-body (2) US{840) rsadsi (113549) 
digestAlgorithm (2 ) 5 } 

sha-1 OBJECT IDENTIFIER ::= 

{ iso{l) identif ied-organization (3) oiw(14) secsig(3) 
algorithm{2) 26 } 

signatureValue: See "signatureValue" on page 189. 

12.4.2.2 SignatureFile location and naming conventions 

The SignatureFile is located in the root directory of the subtree that it signs. There can be several SignatureFiles, as there 
can be several entities that sign the structure. See 12.4.4, "Integration" on page 160. 

By convention, the name of a SignatureFile is: 

"dvb . signaturef ile . "<x> 

where the <x> is a textual representation of an integer decimal number without leading zeroes. The range of values 
represented in any single directory shall start with 1 and increment in steps of 1 . The first unused integer value in the 
ascending sequence indicates the end of the range. 

The purpose of this x is to allow the hash file of an authenticated subtree to be signed by more than one entity. It is equal 
to the X value in the file name of the corresponding certificate file. See 12.4.3.5, "CertificateFile location and naming 
conventions" on page 159 and 12.4.4, "Integration" on page 160. 

12.4.2.3 Supported aigoritlims 

Signing data is a two-step process: 

• first a hash is computed over the data. 

• the resulting hashvalue is then encrypted using an encryption algorithm. 

As indicated in 12.4.1 "HashFile" this specification defines two possible hash algorithms: MD5 and SHA-1. 
The encryption algorithm used to compute the signature is indicated in the certificate that carries this key. 

12.4.2.4 Signature computation rules. 

The hash is computed over the content of the HashFile contained in this root directory. 

NOTE: This is the same principle as for the classical hash computation described in "Digest value 
computation rules" on page 155. 

12.4.2.5 Authentication rules 

See signatureValue on page 158. 
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12.4.3 CertificateFile 
12.4.3.1 Description 

The CertificateFile contains all of the certificates in the certificate chain up to, and including, the root certificate. The leaf 
certificate is placed first in the file. The last certificate in the file is the root certificate. The root certificate is included in 
this file only for consistency. How the MHP terminal determines its policy related to this root CA is implementation 
dependent. The encoding of the certificate is defined in ITU-T X.509 [54]. Below is defined the profile of ITU-T X. 
509 [54] for use in authenticating MHP applications. This profile is based on IETF RFC 2459 [58]. 

The syntax of the CertificateFile is shown in table 5 1 . 

Table 51 : Syntax of the CertificateFile 



Syntax 


Num. Bits 


Format 








Certificatefile () ( 






certif icate_count 


16 


uimsbf 


f or ( i=0; i<certif icate_count; i++ ) ( 






certif icate_length 


24 


uimsbf 


certificate ( ) 
} 
} 







certif icate_count: This 16-bit integer carries the number of certificates in the certificate file. 

certif icate_length: This 24-bit integer specifies the number of bytes in the certificate. 

certificate(): This field carries a single "Certificate" data structure as defined by ITU-T X.509 [54]. See 12.11.1, "Main 
part of the certificate" on page 188. 

12.4.3.2 ASN.1 encoding 

The basic specification of the ASN.l DER encoding used in IETF RFC 2459 [58] is given in ASN.l [57]. However, 
IETF RFC 2459 [58] defines some extensions which are required to implement this specification. 

12.4.3.3 Supported aigoritlims 

There are various algorithm identifiers in the certificate structure. The OID of the algorithm used in the 
SubjectPublicKeylnfo structure shall be RSA. 

The values for Algorithmldentifier used both in the certificate structure and in the TBSCertificate structure that are 
supported in this specification are listed under "signature Algorithm" on page 161. 

12.4.3.4 Name matcliing 

The only allowed encoding of attributes of distinguished names shall be UTF8String. 
NOTE: The use of this encoding allows name matching to be a binary comparison. 

12.4.3.5 CertificateFile location and naming conventions 

As described in 12.2.1.3, "Certificates" on page 153, a key can be authenticated through a "certificate chain". 

A certificate chain is a hierarchy of certificates that enable the implementation to verify the validity of the key used to 
check a signature. In the MHP environment, the root certificate is embedded in the MHP. However, for consistency, the 
file shall carry all of the certificate chain up to, and including, the root certificate. 

The certificate file that leads to the public key of a signature shall be placed in the same directory as that signature file. 

The name of a CertificateFile is: 

' dvb . certif icates . ' <x> 
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where the <x> corresponds to the x value in the file name of the signature file verified by this certificate. Hence in the 
root directory of an authenticated subtree there shall be one certificate file for each signature file. See 12.4.2.2, 
"SignatureFile location and naming conventions" on page 158 and 12.4.4 "Integration". 

12.4.3.6 Authentication rules 

Certificates are considered to be the same if they have bitwise identical contents. 

Where an MHP application is authenticated by multiple signature file / certificate file pairs, the MHP terminal shall check 
all the signature file / certificate file pairs before deciding that a file fails authentication. It is dependant on receiver policy 
whether additional signature file / certificate file pairs are checked once one satisfactory pair has been found. 

12.4.4 Integration 

Logically a file is authenticated as follows: 

a) Confirm that the file is listed in the hash file located in the same directory as the file to be authenticated. 

b) Verify that the file contents and the corresponding digest value are consistent. 

c) Recursively ascend the directory hierarchy checking that each directory is authenticated by its parent directory 
until a directory is found that contains one or more signature files. 

Such a directory is termed the root directory of an authenticated subtree. 

NOTE 1 : This means that there is no requirement to progress above the root of the authenticated subtree to 
examine further hash files. If such a directory has a digest type other than "Non authenticated" in its 
parent directory, this is only significant when verifying the hash file of the parent directory. 

NOTE 2: The presence of more than one signature file enables more than one set of organisations to 
authenticate a subtree. 

NOTE 3: When authenticating a signed application, an MHP terminal can select any one of these certificates 
to use to authenticate all subsequent classes or files loaded. 

Where an MHP terminal trusts more than one of these certificates, it should attempt to select the 
most trusted of these. Apart from this, the mechanism used to make this selection is implementation 
dependent. 

d) For a signature file locate the corresponding certificate file (where the x portion of the signature file's file name 
identifies the certificate file to be used). 

e) If the root certificate in the corresponding certificate file is unknown to the MHP receiver, return to step (d) and 
repeat for the other signature files. 

f) Use the corresponding certificate file to verify that the signature correctly signs the hash file. 

g) Follow the certificate chain contained within the certificate file verifying each link in the chain until the link to the 
root certificate is found. 

h) If the identified root certificate and all the intermediate certificates leading to it are "satisfactory", accept the files 
as being authenticated. 

"satisfactory" depends on the policies implemented in the receiver and other constraints expressed in this 
specification. In particular the requirements in 1 1.2.3, "Class Loading" on page 105 for using the "same" leaf 
certificate to authenticate DVB-J class files shall be observed. 

i) If the identified root certificate or any of the intermediate certificates leading to it are not "satisfactory", return to 
step (d) and repeat for the other signature files. 

j) Dependant on receiver policy return to step (c) and repeat for other signature files. 

NOTE: The above is a logical description of the process and does not constrain implementations to perform 
these steps in this exact order. E.g. hash files may be verified when descending an directory 
hierarchy rather than ascending one. 
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A file system may contain several independent authenticated subtrees, each tree with its own subtree root directory. 

NOTE: For the method org. dvb . dsmcc .DSMCCOb ject . get Signers, the semantics defined in that 
method take precedence over these rules where there are conflicts. 

12.5 Profile of X.509 certificates for authentication of 
applications 

This section identifies how ITU-T X.509 [54] is profiled when used for authentication of broadcast MHP applications. 
This profile is a variation (in general a sub-set) of the internet profile defined in IETF RFC 2459 [58]. This section 
identifies the differences from the profile in IETF RFC 2459 [58]. Section 12. 1 1, "The internet profile of X.509 
(informative)" on page 188 summarises the profile in IETF RFC 2459 [58]. 

12.5.1 signatureAlgorithm 

This specification supports 2 signature algorithms: MD5 with RSA and SHA-I with RSA. 

12.5.1.1 MD5 with RSA 

The signature algorithm with MD5 and the RSA encryption algorithm is defined in IETF RFC 23 13 [56]. As defined in 
IETF RFC 23 13 [56], the ASN. 1 OID used to identify this signature algorithm is: 

mdSWithRSAEncryption OBJECT IDENTIFIER ::= { 

iso(l) member-body (2) us(840) rsadsi (113549) pkcs(l) pkcs-l(l) 4 } 

12.5.1.2 SHA-1 with RSA 

The signature algorithm with SHA-I and the RSA encryption algorithm is implemented using the padding and encoding 
conventions described in IETF RFC 2313 [56]. The message digest is computed using the SHA-I hash algorithm. The 
ASN.l object identifier used to identify this signature algorithm is: 

sha-lWithRSAEncryption OBJECT IDENTIFIER ::= { 

iso{l) member-body (2) us(840) rsadsi (113549) pkcs(l) pkcs-l(l) 5 } 

12.5.1.3 parameters 

For both of the 2 supported algorithms the parameters component shall be the ASN.l type NULL. 

12.5.2 signatureValue 

The RSA signature generation process and the encoding of the result is described in detail in IETF RFC 23 13 [56]. 

12.5.3 version 

The version field of the certificate shall signal v3. All implementations shall support the v3 extensions as required by 12. 
5.9, "Extensions" on page 163. 

12.5.4 issuer 

12.5.4.1 minimum requirement 

For this specification at least a Common Name attribute shall be provided. The text value of the attribute shall be non- 
empty. It shall be suitable for direct presentation to the user. 

12.5.4.2 certificate authority responsibility 

The senior certificate authority who signs a certificate shall oversee the attribute information to ensure that the 
information is suitable. 



ETSI 



162 ETSITS 101 812V1.3.1 (2003-06) 

12.5.5 validity 

The only allowed format for encoding time in the validity field is GeneralizedTime. 

12.5.6 subject 

The subject field is a "distinguished name". The following requirements are specified by this specification: 

• The only allowed encoding attributes of the subject is UTFSString (see 12.4.3.4, "Name matching" on 
page 159) 

• The minimum set of attributes that shall be present in the subject are: 

- commonName 

- count ryName 

• If the certificate is a "leaf certificate" (see figure 14, "Certificate chain illustrated" on page 153) then the subject 
shall also contain an organizationName. 

• When encoded the organizationName carries organisation specific text post fixed by the organisation_id of 
the authenticated files. This integer value is represented as a fixed length 8 character hexadecimal string (with 
leading zeros where required). So the organizationName takes the form: 

text + " . " + organisation_id 

Except for the presence of leading zeros, this is the same as 14.5, "Text encoding of application identifiers" on 
page 222. 

This field reproduces the organisation_id value from the application's application identifier, see 10.5.1, 
"Encoding" on page 83. Before the application starts executing, the value of the organisation_id of at least one of 
the leaf certificates used in the authentication of the application's root subdirectory must match that in the 
application identifier. If this is not true, then the application is considered to have failed authentication. 
Applications which fail authentication at this point shall not be started on MHP terminals. 

12.5.7 SubjectPublic Key Info 

This specification supports a single public key algorithm (RSA) for the subject public key. 

The key lengths that implementation are required to support are addressed in G, "(normative): Minimum Platform 
Capabilities" on page 355. 

12.5.7.1 rsaEncryption 

The OID rsaEncryption identifies RSA public keys: 

rsaEncryption OBJECT IDENTIFIER ::= { pkcs-1 1} 

pkcs-1 OBJECT IDENTIFIER ::= { iso(l) member-body (2 ) us (840) 

rsadsi (113549) pkcs(l) 1 } 

The parameters field shall have ASN. 1 type NULL. 

12.5.7.2 subjectPublicKey 

The RS subjectPublicKey BIT STRING shall be encoded using the ASN.l type RSAPublicKey: 

RSAPublicKey ::= SEQUENCE { 

modulus INTEGER, -- n 

publicExponent INTEGER -- e -- } 

The semantics of the modulus (n) and the public exponent (e) are defined in IETF RFC 23 13 [56]. 
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12.5.8 Unique Identifiers 

X.509 defines the issuerUniquelD and sub jectUniquelD extensions. 

CAs conforming to this profile shall not generate certificates with unique identifiers. 

MHP terminals conforming to this profile are not required to be capable of parsing unique identifiers and making 
comparisons. 

12.5.9 Extensions 

The following restrictions and semantics are placed on the use of certificate extensions when used to authenticate 
applications. 

Table 52 : Profile for standard certificate extensions 



Extension 


(A 

+.» 
(A 

n> 

2 

.Q 


In 
implementations 


Semantic 


Authority key identifier 


Opt. 


Opt. 


Shall not be marked critical 


Subject l<ey identifier 


Opt. 


Opt. 


Shall not be marked critical 


Key usage 


Mand. 


Mand. 


If the keyUsage extension is marked critical, for the leaf 
certificate the bit digitalSignature shall be set, for other 
certificates the bit keyCertSign shall be set. If these bits are not 
set then the certificate shall be ignored by the implementation. 


Private l<ey usage period 


Opt. 


Opt. 


Shall not be marked critical 


Certificate policies 


Opt. 


Opt. 


Shall not be marked critical 


Policy mappings 


Opt. 


Opt. 


Shall not be marked critical 


Subject Alternative Name 


Mand. 


Opt. 


Shall not be marked critical 

The subject name unambiguously identifies the subject. 
It is recommended that DVB MHP implementations can read 
rfc822Name (email address) 


Issuer Alternative Name 


Mand. 


Opt. 


Shall not be marked critical 

The issuer name unambiguously identifies the issuer. 

It is recommended that DVB MHP implementations can read 

rfc822Name (email address). 


Subject Directory attributes 


Opt. 


Opt. 


Shall not be marked critical 


Basic Constraints 


Opt. 


Mand. 


May be marked critical 


Name Constraints 


Opt. 


Mand. 


May be marked critical. 

DVB MHP decoders shall be able to recognise name constraints 

when GeneralName are either directoryName or rfc822 names. 


Policy Constraints 


Opt. 


Opt. 


Shall not be marked critical 


Extended key usage field 


Opt. 


Opt. 


Shall not be marked critical 


CRL Distribution points 


Opt. 


Opt. 


Shall not be marked critical 
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Table 53 : Key for table 52 



Keyword 


When applied to ... 


broadcasts 


receivers 


Mandatory 


Certificates shall include these extensions. 


Receivers shall observe the semantic for this 
information when provided. 


Optional 


Certificates may or may be not include these 

extensions. 

The MHP specification does not define the use 

of these extensions and hence broadcasters 

should not use them. 


Receivers can ignore these extensions if 
present. 


Critical / 
not-critical 


Broadcasters should not mark the receiver 
optional extensions as critical. 


Certificates containing unrecognised critical 
extensions shall be considered as invalid. 
Receivers should recognise all the extensions 
that can be critical. 



12.6 Security policy for applications 

12.6.1 General principles 

This section specifies the resource access poHcy for the downloaded applications. The resource access policy depends on 
two factors 

• The access rights requested by the broadcaster through the signalling 

• The access rights granted by the user. 

The ultimate access rights that are granted to the applications are the intersection of the access rights requested by the 
broadcaster and the access rights granted by the user. 

Unsigned applications have limited access to platform resources. 

Unless specified elsewhere in this specification, signed applications have the same access rights as unsigned applications. 
An application broadcaster can request additional permissions to access specific resources by providing a signed 
"Permission Request File" along with the application. The syntax and semantics of the Permission Request File are 
defined in the following sections. The permission request file may also contain a credential that indicates that a persistent 
file owned by another organisation may be accessed. If the "Permission Request File" is not correctly authenticated the 
application is not granted any additional permissions but is not prevented from starting for this reason. 

The way the user grants rights to the downloaded applications is implementation dependant and is not addressed by this 
specification. 

For DVB-J applications, accessing a resource consists of method calls. Each method call that results in accessing the 
resource shall throw a security exception as defined in 11.10, "Java permissions" on page 1 4 1 and the specifications of 
the Java APIs concerned. For each resource subject to access restriction, the application can test whether it has been 
granted permissions to access itby using the correspondingjava Permission class (See 11.8, "Security" on page 138). 

For a DVB-J application to be correctly authenticated, all the class files that the application consists of need to be signed, 
the signatures need to verify (see 12.4.4, "Integration" on page 160) and the application_id needs to be from within the 
range allocated to signed applications (see Table 12, "Value ranges for application_id" on page 84). If, during the loading 
or execution of the application the MHP detects a signed file containing a class that failed to pass the authentication 
process (e.g. because its actual hash value does not match the expected hash value), then the class shall be considered as 
not available. 

When an application requests to retrieve data from a file that is signalled as being signed, but for which the MHP failed to 
match the computed hash value and the expected hash value, then the API concerned shall fail in a manner consistent 
with the defined behaviour of that API when the file exists but has no content in it. 
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NOTE: In order to be efficient, if a directory D contains objects tliat are likely to frequently change, it is 

advised to put a signature file in this directory D and to mark the directory D as non authenticated in 
the hashfile located in the parent directory of D. By doing so, it will limit the propagation of 
modifications to just one directory. 

The authentication of a file is evaluated each time that the file is loaded from a transport connection. File version 
information in the transport system cannot be assumed to be secure. 

Applications authors should be aware that deciding whether to grant a permission or not may, depending on the 
implementation, involve prompting and asking the end user. The latest point in time when the implementation must 
decide if an application has a permission or not is when the application either queries the presence of this permission for 
the first time or when it invokes an action that requires the permission for the first time. Application authors should be 
aware that in these situations, an implementation may prompt and ask the user. Depending on the implementation, this 
prompting (if necessary) can also happen at any point in time prior to this (e.g. at the application start up time). 

An MHP terminal is required to be able to operate in a mode where it grants permission to provide access to all of the 
functionality required by the profiles and options that it supports when appropriately requested (e.g. via the permission 
request file). The mechanism for causing the terminal to operate in this mode is implementation-dependent. The granting 
of permissions for accessing functionality outside of the claimed MHP profile and options is not required. 

NOTE: In the case of permissions represented by a Java class in DVB-J, this means that it will be possible 
to have such a permission granted if the corresponding class is required in the given profile, and it 
can be requested in the permission request file. 

NOTE: This means that, for example, it must be possible to grant the permission associated with dialling a 
phone number on a terminal that supports the interactive broadcast profile, even if the terminal 
implements the interaction channel using a cable modem. In this case, the dialling APIs will fail in 
a manner consistent with this specification. 

12.6.2 Permission request file 
12.6.2.1 File encoding 

The Permission Request File is an XML File. Its syntax is defined by the following DTD. The Name used in the 
document type declaration shall be "permissionrequestfile". 

The PublicLiteral to be used for specifying this DTD in document type declarations of the XML files is: 

"-//DVB//DTD Permission Request File 1.0//EN" 

and the URL for the SystemLiteral is: 

"http : //www . dvb . orq/mhp/dtd/permissionrequestf ile-l-Q . dtd" . 

The DTD is: 

<! ELEMENT permissionrequestfile 

(file?, capermission?, applif ecyclecontrol?, returnchannel?, tuning?, 
servicesel?, userpref erences?, network?, dripfeed?, persistentfilecredential*)> 
<!ATTLIST permissionrequestfile 
orgid CDATA #REQUIRED 
appid CDATA #REQUIRED 
> 

<! ELEMENT file EMPTY> 
<!ATTLIST file 

value (true I false) "true" 

> 
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<!ELEMENT capermission (casystemid) +> 

<! ELEMENT casystemid EMPTY> 

<!ATTLIST casystemid 

entitlementquery (true I false) "false" 

id CDATA #REQUIRED 

mmi (true I false) "false" 

messagepassing (true I false) "false" 

buy (true I false) "false" 



<! ELEMENT applif ecyclecontrol EMPTY> 
<!ATTLIST applifecyclecontrol 

value (true I false) "true" 



<! ELEMENT returnchannel (def aultisp?, phonenumber*) > 

<! ELEMENT defaultisp EMPTY> 

<! ELEMENT phonenumber (#PCDATA)> 

<! ELEMENT tuning EMPTY> 
<!ATTLIST tuning 

value (true I false) "true" 



<! ELEMENT servicesel EMPTY> 
<!ATTLIST servicesel 

value (true I false) "true" 



<! ELEMENT userpref erences EMPTY> 

<!ATTLIST userpreferences 

write (true I false) "false" 

read (true I false) "true" 



<! ELEMENT network (host)+> 
<! ELEMENT host (#PCDATA)> 
<!ATTLIST host 

action CDATA #REQUIRED 



<! ELEMENT dripfeed EMPTY> 
<!ATTLIST dripfeed 

value (true I false) "true" 



< ! ELEMENT per sistent f ilecredent ial (grantoridentif ier , expirationdate, f ilename+, signature, 

certchainf ileid) > 

<! ELEMENT grantor identifier EMPTY> 

<!ATTLIST grantoridentif ier 

id CDATA #REQUIRED 

> 

<! ELEMENT expirationdate EMPTY> 
<!ATTLIST expirationdate 

date CDATA #REQUIRED 

> 

<! ELEMENT filename (#PCDATA)> 
<!ATTLIST filename 

write (true I false) "true" 

read (true | false) "true" 

> 

<!ELEMENT signature (#PCDATA)> 
<!ELEMENT certchainf ileid (#PCDATA)> 
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12.6.2.1.1 Number representation 

12.6.2.1.1.1 Hex 

Unless stated otherwise (e.g. section 14.5, "Text encoding of application identifiers" on page 222) each hexadecimal 
value has the following form "Ox" Nhex where "N" specifies the fixed number of significant digits in the value and hex is 
specified by the following BNF: 

"d" I "e" I "f" 



hex = digit 


"A" 


"B" 


"C" 


"D" 


"E" 


"F" 


" a " 


"b" 


"c 


digit = "0" 


"1" 


"2" 


" 3 " 


" 4 " 


" 5 " 


" 6 " 


" 7 " 


" 8 " 


"9 



12.6.2.2 File integrity 

If the permission file is not parsable as defined by the XML parsing rules (see 14.3, "XML notation" on page 220) it shall 
be ignored and hence no additional permissions are granted. 

12.6.2.3 Example 

<?xml version="l . 0" ?> 

<!DOCTYPE permissionrequestf ile PUBLIC "-//DVB//DTD Permission Request File 1.0//EN" 

"http : / /www . dvb . org/mhp/dtd/permissionrequestf ile-1-0 . dtd"> 

<permissionre quest file orgid=" 0x00002 3 d2" appid="0x4 02 0"> 

<f ile value="true"></f ile> 

<capermission> 
<casystemid 

id="Oxllll " messagepassing="true" 
entitlementquery="true" mini = " false "> 
</casystemid> 
</capermission> 

<applifecy decontrol value="true"></applif ecyclecontrol> 

<returnchannel> 

<def aulti spx/ default isp> 

<phonenumber>+3583111111</phonenumber> 

<phonenumber>+3583111112</phonenumber> 

<phonenumber></phonenumber> 
</returnchannel> 

<tuning value="f alse"></tuning> 

<servicesel value="true"></servicesel> 

<userpref erences read="true" write=" false "></userpreferences> 

<network> 

<host act ion=" connect ">hostname< /host > 
</network:> 

<pers i stent fi leer edential> 

<grantoridentif ier id- "0x0 5 "></grantoridentif ier> 

<expirationdate date="2 4/ 12/2032 "></expirationdate> 

<f ilename read="true" write=" false ">5/ 15 /dirl/scores</filename> 

<f ilename read="true" write=" false ">5/15/dirl/names</filename> 

<signature>0232032 932 92 932 932 9214 93143 92 94239432 9423 9432 

</signature> 

<certchainf ileid>3</certchainf ileid> 
</pers i stent fi leer edential> 

</ pe rmi s s ion re quest f ile > 
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12.6.2.4 Permission request file name and location 

The format for the permission request file name is: 

' dvb . ' <application name>'.perm' 

The prefix "dvb" identifies this as a well known file specified by this specification. The portion "application name" carries 
the file name of the initial file of the application excluding any file name extension or suffix. The initial file depends on 
the application type as is shown in table 54 for the types defined in this specification. 

Table 54 : Application name for different application types 



Application type 


Path from which file name shall be extracted 


Value 


Meaning 


0x0001 


DVB-J 


The name initial_class_byte, see table 34 on page 98 


0x0002 


DVB-HTML 


The name initial_path_bytes, see table 36 on page 100 



This file shall be located in the same directory as the initial file. 

12.6.2.5 Permission request file 

12.6.2.5.1 Minimum permissions 

If the permission file does not contain a valid permissionrequestfile element it shall be ignored and hence no additional 
permissions are granted. 



12.6.2.5.2 



Syntax and semantics 



<!ATTLIST permissionrequestfile 
orgid CDATA #REQUIRED 
appid CDATA #REQUIRED 



orgid: This attribute is a hexadecimal string (hex_string) that conveys the organisation id of the associated application. 
The encoding of this value is specified in 14.5, "Text encoding of application identifiers" on page 222. 

appid: This attribute is a hexadecimal string (hex_string) that conveys the application id of the associated application. 
The encoding of this value is specified in 14.5, "Text encoding of application identifiers" on page 222. 

12.6.2.5.3 Defaults 

NOTE: As defined by XML 1 .0 [65], the defaults for attributes defined in the DTD (see 12.6.2. 1 , "File 
encoding" on page 165) only apply when the element is present but the attribute concerned is 
omitted. 

12.6.2.6 Credentials 

A credential contains a resource description and is used to allow the owner of this resource (the grantor) to grant to the 
permission request file's application to access it. In this specification, the only resource that can be contained in a 
credential is a file (or a set of files of a directory). Credentials shall not grant access to directories, only files within them. 
This type of credential is named persistentf ilecredential in the XML DTD. The credential contains an 
expiration date that allow the grantor to grant access to its resource for a limited duration. The credential is signed by the 
grantor. The signature checking is done by the implementation by getting the certificate of the grantor. The certificate can 
be found thanks to the information contained in the certchainf ileid element. 

The certificate file that leads to the public key of the signature shall be placed either in the same directory as the 
permission request file containing the credential or in one of its parent directories. The directory containing the 
permission request file shall be searched first and then recursively ascend the directory hierarchy checking certificate files 
until one is found with the file name matching the contents of the certchainf ileid field of the credential. If the root 
of the file system is reached without finding a matching certificate then the file access shall not be granted. 
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The grantoridentifier in the persistent filecredential shall match the organisation_id contained in the Subject 
organisationName field of the leaf certificate for file access to be granted. 

The persistent file credential is transmitted using the following XML DTD syntax: 

< ! ELEMENT per sistent filecredential (grantoridentifier, expirationdate, f ilename+, signature, 

certchainf ileid) > 

<! ELEMENT grantoridentifier EMPTY> 

<!ATTLIST grantoridentifier 

id CDATA #REQUIRED 
> 

<! ELEMENT expirat iondate EMPTY> 
<!ATTLIST expirationdate 

date CDATA #REQUIRED 
> 

<! ELEMENT filename (#PCDATA)> 
<!ATTLIST filename 

write (true I false) "true" 

read (true I false) "true" 
> 

<! ELEMENT signature (#PCDATA)> 
<! ELEMENT certchainf ileid (#PCDATA)> 

The following table provide more information about the different elements: 

Table 55 : 



Elements 


Comments 


grantoridentifier 


This element contains the 32 bit organization id identifying 
the grantor organization. The encoding of the CDATA attribute 
id of this element is given in 14.5, "Text encoding of 
application identifiers" on page 222. 


expirationdate 


This element contains the expiration date of this credential. 
The implementation should ignore the certificate if the date 
has expired. The CDATA attribute date shall follow the 
following BNF syntax: 

2dec "/" 2dec "/" 4dec ; e.g. "01/12/2001" 

where: 

dec = "0" 1 "1" 1 "2" 1 "3" 1 "4" 1 "5" | "6" 
"7" 1 "8" 1 "9" 

Where the first 2 digits are the day number in the month, the 
second two digits are the month number in the year and the 
last 4 digits are the year All values are in accordance with the 
Gregorian calendar. 

NOTE: Numbers start counting from one and not zero unlike 
the java.util.GregorianCalendar class. 
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Table 55 



Elements 



Comments 



filename 



This element contains the filename path and the read/write 
access rights that are granted on the file. The element 
consists of a CDATA string following the following BNF 
syntax: 

filename = persistentf ilename 

persistentpath "/" persistentf ilename 
I persistentpath "/" "*" 
I persistentstpath "/" "-" 

where 

"/" is the file separator 

"*" used at the end of a pathname indicates all files contained 

in that directory 

"-" used at the end of a pathname indicates all files contained 

in that directory and existing subdirectories recursively at the 

time the permission request file is parsed. 

persistentpath, persistentf ilesubstring and 
persistentf ilename are defined in 14.6.1, "Persistent 
storage" on page 223. 

The file path is relative to the path obtained from the dvb . 

persistent . root property. 

Receivers are required to support the same restrictions on 
the lengths of persistentf ilesubstrings and 
persistentf ilesuf fixes as specified in 14.6.1 , 
"Persistent storage" on page 223. 

The file path shall not start with a "/". It is relative to the path 
obtained from the dvb. persistent .root property. 
The element has two attributes read and write that can take 
the value "true" or "false". 



signature 



This element contains a signature from the grantor. Signature 
structure is as defined section 12.4.2, "SignatureFile" on 
page 157. 

The signature is encoded using the Base64 content transfer 
encoding as specified in section 6.8 of IETF RFC 2045 [64]. 



certchainfileid 



This element contains the identifier of the leaf certificate, i.e. 
the "x" in the file name "dvb. certificates. x". 
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The signature is computed on the binary concatenation of the following fields in the following order: 

Table 56 : 



Fields 


Binary content 






grantee_identif ier . organization_id 


32 bits 


grantee_identif ier . application_id 


16 bits 


grantor_identif ier (organization_id) 


32 bits 


expiration_date 


10 characters (e.g. "10/12/2001") in 

ASCII 


filenames & actions (in the order they 
appear in the XML document) i.e.: 

for (i=0; i<f ilenumber; i++) { 
read 
write 
filepath 

} 


4 or 5 char ("true" or "false") 

4 or 5 char ("true" or "false") 

string in ASCII (without any string 
termination character) 



The implementation will check the validity of the credential by checking the signature with the grantor's public key that 
can be found in the grantor's certificate. Certificates are carried by the grantee in the file format defined section 12.4.3, 
"CertificateFile" on page 159. Certification chain authenticates grantor's certificate. This chain shall derive from one of 
the root authorities embedded in the MHP. 

The right to access a file shall not include the right to create it. 

12.6.2.7 File Access 



12.6.2.7.1 



Unsigned applications 



Have no access to the persistent storage 

12.6.2.7.2 Policy for signed applications 

No access to the persistent storage, unless otherwise indicated in the Permission File. 

When the permission request file requests access to persistent storage and this is granted, the file access policy is derived 
from the policy used in the Unix world. 

An application owns the files it has created. The root directory of the persistent file namespace is defined by the 'dvb. 
persistent.root' property as described in 1 1.5.6, "Persistent Storage API" on page 126. The files owned by an application 
shall be located in sub-directories below this directory, specifically one of the following two choices: 

a) the sub-directory whose name is the organisation_id of the application concerned. 

b) a sub-directory of the immediately previously defined directory whose name is the application_id of the 
application concerned. 

The encodings of the organisation identifier and application identifier are as defined in 14.5, "Text encoding of 
application identifiers" on page 222. By default, files created by an application will have owner read/write access only. 
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An Application can modify the access rights to a file it owns as follows: 

• it can grant a read-only access, a write-only access or a read-write access to all applications having the same 
organisationid value. 

• it can grant a read-only access, a write-only access or a read-write access to all applications. 

• write access to a directory is required to add or remove an entry in a directory. 

• read access to a directory is required to list the contents of a directory or access any of the files contained within in 
it. 

• to read the contents of a file or directory, permission to read that file or directory and all directories on the path to 
the root of the persistent file system is required. 

An application shall be granted access to a file if it qualifies for such access by application, organisation or world access 
permissions. 

An application's right to access a file is the union of the rights granted by the credential mechanism and the right granted 
by the file permission mechanism. 

See org.dvb.io.persistent see K, "(normative): DVB-J persistent storage API" on page 389. 

12.6.2.7.3 Permission request syntax 

<! ELEMENT file EMPTY> 
<!ATTLIST file 
value (true I false) "true" 



12.6.2.8 CAAPI 

12.6.2.8.1 Unsigned applications 

An unsigned application caimot access the following methods: 

• CAModule . buyEntitlements 

• CAModule . openMessageSession 

• CAModuleManager .addMMIListener 

• CAModule . queryEntitltements 

• CAModule . listEntitlements. 

12.6.2.8.2 Signed applications 

By default, an application has limited access to the CA API functions (same default rights as an unsigned application) 
In particular, the following method calls are not accessible to an unsigned application: 

• CAModule . buyEntitlements 

• CAModule . openMessageSession 

• CAModuleManager .addMMIListener 

• CAModule . queryEntitltements 

• CAModule . listEntitlements. 

The permission request file requests the MHP to grant additional rights to the application with the ConditionalAccess 
Permission described below. 
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12.6.2.8.3 Conditional Access Permission syntax 

The ConditionalAccess Permission is optional. When not present, the appHcation has the default access rights. When 
present, the permission request file overrides the default rights for this application. 

<! ELEMENT capermission (casystemid) +> 

<! ELEMENT casystemid EMPTY> 
<!ATTLIST casystemid 

entitlementquery true I false) "false" 

id CDATA #REQUIRED 

mmi (true I false) "false" 

messagepassing (true I false) "false" 

buy (true I false) "false" 
> 

The string specifying the CA system IDs has the following syntax: 

CAIds = CASystemId 1 "[" CASystemId "-" CASystemId "]" I "*" 

CASystemId = "Ox" 4hex 

See 12.6.2.1.1.1, "Hex" on page 167. 

12.6.2.9 Application lifecycle control policy 

Applications shall not launch broadcast applications that are not signalled in the currently selected service for the service 
context in which the application wishing to do the launching is running. 

12.6.2.9.1 Unsigned applications 

An unsigned broadcast application can launch any application visible in the listing API that is signalled in the currently 
selected service for the service context in which the application wishing to do the launching is running. 

An unsigned application can control (pause, stop, resume) the lifecycle of an application it has launched. 

An unsigned application cannot control the lifecycle of an application it has not launched. 

12.6.2.9.2 Default policy for Signed applications 

By default, a signed application has the same rights as an unsigned application as concerns the application lifecycle 
control policy. 

These default rights can be overridden by the permission request file as described below. 

12.6.2.9.3 Syntax 

<! ELEMENT applif ecyclecontrol EMPTY> 
<!ATTLIST applifecyclecontrol 
value (true I false) "true" 



value: When the boolean value is set to true, this means that the application can control the lifecycle of all the 
applications signalled in the currently selected service for the service context in which the application wishing to do the 
launching is running. When set to false the poHcy is as in 12.6.2.9.2, "Default policy for Signed applications" on 
page 173. 

12.6.2.10 Return channel access policy 
12.6.2.10.1 Unsigned applications 

An unsigned application may not use the return channel. 
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12.6.2.10.2 Signed applications 

By default, a signed application may not access the return channel, unless otherwise specified by the permission request 
file. The syntax of the return channel permission is so that it describes the phone numbers that the application may try to 
dial. 

12.6.2.10.3 Return ciiannel permission syntax 

<! ELEMENT returnchannel (def aultisp?, phonenumber*) > 
<! ELEMENT phonenumber (#PCDATA)> 

<! ELEMENT def aultisp EMPTY> 

The syntax of the phone number string is as defined below. 

phonenumber = "+" digit digits I digits 

digits = "" I digit digits 

digit = "0" I "1" I "2" | "3" I "4" | "5" I "6" | "7" | "8" | "9" 

The presence of the def aultisp tag indicates that the application is allowed to use the default ISP connection. If this 
tag is not present, then the application shall not be able to specify coimecting to the default target except where the 
connection parameters for that target are explicitly specified by the application and are included in the phone number 
string. 

When a phone number is given, this number defines a prefix of the allowed phone numbers and applications are allowed 
to call to all numbers that start with one of the prefixes defined in the permission request file, subject to the MHP terminal 
granting this right (see 12.6.1, "General principles" on page 164). 

NOTE: By defining an empty phone number tag (i.e. empty string as the prefix), the application could try to 
call to any phone number. 

12.6.2.11 Tuning access policy 

12.6.2.11.1 Unsigned applications 

An unsigned application may not tune using the Tuning API. 

12.6.2.11.2 Signed applications 

By default, a signed application may not tune using the Tuning API. However, the right to tune can be requested with the 
Tuning permission that can be put in the permission request file. 

12.6.2.11.3 Tuner Permission syntax 
The syntax of this permission is as follows: 

<! ELEMENT tuning EMPTYx 

<!ATTLIST tuning 

value (true I false) "true" 
> 

The value true requests the permission to tune using the Tuning API. 

12.6.2.12 Service selection policy 

12.6.2.12.1 Unsigned applications 
Unsigned applications may not select a new service. 

12.6.2.12.2 Signed applications 

By default, signed applications can select any new service, unless otherwise specified in the permission request file. 
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12.6.2.12.3 Service Selection Permission 

The syntax of the service selection permission is as follows: 

<! ELEMENT servicesel EMPTY> 

<!ATTLIST servicesel 

value (true I false) "true" 
> 

If no service selection permission is present in the permission request file, the application has the default right, i.e. it can 
select any service. 

The value "false" in this item in the permission request file, denies the right to select a new service. 

1 2.6.2. 1 3 Media API access policy 

The media API is inside the sandbox. 

12.6.2.14 Inter-application communication policy 

12.6.2.14.1 Unsigned applications 

Unsigned applications are allowed to communicate with each other through the inter-application communication API. 
However, an unsigned application is not allowed to communicate with a signed application through the inter-application 
communication API. 

12.6.2.14.2 Signed applications 

Signed applications signalled in the same service are allowed to communicate with each other through the inter- 
application communication API. 

No special Permission need be defined. 

12.6.2.15 User Setting and Preferences access policy 

12.6.2.15.1 Unsigned applications 
Read access to: 

• User Language 

• Parental Rating 

• DefaultFontSize 

• Country Code 

An unsigned application cannot access (neither read nor write) other preferences 

12.6.2.15.2 Signed applications 

By default, same as unsigned applications. The permission request file may include items that request read access to all 
user preferences and/or write access to all user preferences. 

12.6.2.15.3 Permission syntax 

<! ELEMENT userpref erences EMPTY> 

<!ATTLIST userpreferences 

write (true I false) "false" 

read (true I false) "true" 
> 

True value in the write and read attribute means that the permission for writing and reading, respectively, is requested. 
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12.6.2.16 Network permissions 

12.6.2.16.1 Unsigned applications 

Unsigned applications can not have access to the return channel and therefore can not access remote network hosts. 

12.6.2.16.2 Signed applications 

For signed applications, the permission request file can contain a set of permissions that specify the hosts and actions for 
which permissions are requested. 

12.6.2.16.3 Permission syntax 

<! ELEMENT network (host)+> 
<! ELEMENT host (#PCDATA)> 
<!ATTLIST host 

action CDATA #REQUIRED 
> 

The two strings that specific the host and the action shall be formatted as specified in the Java . net . 
SocketPermission class as defined in 11.8, "Security" on page 138. 

12.6.2.17 Dripfeed permissions 

12.6.2.17.1 Unsigned applications 
Has no access to drip feed mode. 

12.6.2.17.2 Default policy for signed applications 

No access to drip feed mode unless otherwise indicated in the Permission file. When an application is granted access to 
the drip feed mode, it is able to instantiate aDripFeedDataSource. 

12.6.2.17.3 Permission request syntax 

<! ELEMENT dripfeed EMPTY> 
<!ATTLIST dripfeed 

value (true I false) "true" 
> 

12.7 Example of creating an application that can be 
authenticated 

12.7.1 Scenario Example 

This section is informative and gives an example of how a file system carrying an application can be organised. 

In this example, the file system carries single signed application Xletl. 

The main class of the application is the file root /Xletl/classes/Xletl. class, other files comprising the 
application are the following classes: 

• root/Xletl/classes/f col . class 

• root/Xletl/classes/subclasses/subl. class 

• root/Xletl/classes/subclasses/sub2. class 

Xletl consumes data located in the file root /Xletl /data /Xletl . dat. This file is not authenticated. 
Each subdirectory that contains signed files contains a hashfile. 
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Assumptions in this example: 

• All the *. class files are signed 

• The file root/Xletl/data/Xletl . dat is not signed 

• The only digest algorithm used is MD5 
The file structure is shown below: 




classes 



Xlet1.dat 




foolclass 



dvb.hashfile 



dvb.Xlet1.perm 





-^ 


^^^ 


sub1. class 


sub2. class 


dvb.hashfile 



Figure 15 : Example of an authenticated file tree 

12.7.2 Hashes and signature computations: 

12.7.2.1 Computation of the hashes of the root/Xletl /classes/subclasses directory 

a) initialise the MD5 algorithm 

b) apply the contents of the file root /Xletl/classes/subclasses/subl. class to the MD5 algorithm 
then apply the contents of the file root/Xletl/classes/subclasses/sub2 .class to the MD5 
algorithm. The cumulative result from these two files is the result HO 

c) construct the contents of the hash file for the directory root/Xletl/classes/subclasses/as follows : 

Table 57 : root/Xlet1/classes/subclasses/dvb.hashfile 



Field 


Comment 


1 


One digest 


1 


Type of digest algorithm = MDS 


2 


Number of entries over which a MDS hash has been computed 


subl .class 


List of names of entries 


sub2 .class 


HO 


IVIDS hash of files subl . class and sub2 . class 



NOTE: In this example we have chosen that the digests for this directory result from processing the 
concatenation of the contents of the files in the directory. 

d) create the hash file root/Xletl/classes/subclasses/dvb .hashf lie with the above contents 
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1 2.7.2.2 Computation of the hashes of the of root/Xlet1 /classes directory 

e) initialise the MD5 algorithm, compute the MD5 hash H2 using the contents of the file 

root/Xletl/classes/subclasses/dvb .hashf ile 

f) initialise the MD5 algorithm, compute the MD5 hash H3 using the contents of the file 

root/Xletl/classes/Xletl. class 

g) initialise the MD5 algorithm, compute the MD5 hash H4 using the contents of the file 

root/Xletl/classes/fool. class 

h) construct the contents of the hash file for the directory root/Xletl/classes/ as follows : 

Table 58 : root/Xlet1/classes/dvb.hashfile 



Field 


Comment 


3 


Three digests 


1 


Type of digest algorithm = MD5 


1 


Number of entries over which a IVID5 hash has been computed 


subclasses 


List of names of entries 


H2 


MDS hash of subclasses directory 


1 


Type of digest algorithm = MDS 


1 


Number of entries over which a IVID5 hash has been computed 


Xletl. class 


List of names of entries 


H3 


MDS hash of file xletl . class 


1 


Type of digest algorithm = MDS 


1 


Number of entries over which a MDS hash has been computed 


fool .class 


List of names of entries 


H4 


MDS hash of file fool . class 



NOTE: In this example we have chosen to individually hash each object in this directory, 
i) create the hash file root/Xletl/classes/dvb .hashf ile with the above contents 

1 2.7.2.3 Computation of the hashes of the of root/Xlet1 directory 

j) initialise the MDS algorithm, compute the MDS hash HS using the contents of the file 

root/Xletl/classes/dvb .hashfile 

k) construct the contents of the hash file for the directory root/Xletl/classes/ as follows : 

Table 59 : root/Xletl/dvb.hashfile 



Field 


Comment 


3 


Three digests 


1 


Type of digest algorithm = MDS 


1 


Number of entries over which a MDS hash has been computed 


classes 


List of names of entries 


H5 


MDS hash of the classes directory 





Type of digest algorithm = non authenticated data 


1 


Number of entries over which a MDS hash has been computed 


data 


List of names of entries 


<no digest in this case> 





Type of digest algorithm = non authenticated data 


1 


Number of entries over which a MDS hash has been computed 
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Table 59 : root/Xletl/dvb.hashfile 



Field 


Comment 


dvb.certificates.1 
List 


List of names of entries 


<no digest in this case> 



NOTE: the root/Xletl/classes entry is the only authenticated entry of the root/Xletl directory 
1) create the hash file root/Xletl/dvb.hashfile with the above contents 

12.7.2.4 Computation of the signature 

m) initialise the MD5 algorithm, compute the MD5 hashH6 using the contents of the file root/Xletl/dvb. 
hashf lie 

n) RS A-encrypt H6 with the private key corresponding to the public key that can be found in the leaf certificate in 
the file root/Xletl/dvb . certificates . 1. In this example this has serial number 0123456. 

o) ASN.l encode the following structure: 

• AuthorityCertlssuerName: Name of the CA 

• AuthorityCertSerialNumber: 0123456 

• HashSignatureAlgorithm: MD5 

• Signature Value: result of step (n). 

p) put this structure into the signature file root/Xletl/dvb . signaturef lie . 1 

NOTE: The file system could contain other Xlets in their own authenticated sub-trees. If these use the same 
certificate chain as Xletl (above) then logically the certificates file is replicated at the root of each 
of the authenticated sub-trees. Some file systems support symbolic links. These may in some cases 
improve the efficiency of the broadcast. 

12.8 MHP certification procedures 

The MHP certification procedures are outside of the scope of this document. 

12.9 Certificate management 

12.9.1 Certificate Revocation Lists 

12.9.1.1 Introduction (informative) 

Certificates may be revoked prior to their expiration time, e.g. if the broadcaster's private key is assumed to be 
compromised, or the broadcaster is no longer to be certified by the CA. Each CA publishes a list of revoked certificates, 
called a CRL (Certificate Revocation List). This contains the list of the serial number of revoked certificates. 

During the validation process of a certificate chain, the CRL of each certification authority on the certification path is 
checked. 

The number of CRLs to be supported per level is defined in G, "(normative): Minimum Platform Capabilities" on 

page 355. 

12.9.1 .2 Distribution of CRLs (informative) 

Two routes from the broadcaster to the MHP terminal can be envisaged: 

• via the return channel 

• in the broadcast MPEG stream 
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12.9.1.2.1 Distribution via return ciiannel 

In the certificate extension fields, tliere is an optional field called "CRL Distribution points". This field can hold a URL 
pointing to a crlFile which can be downloaded. 

This approach is suitable for obtaining CRLs relating to TLS authentication of return channel exchanges. It is not 
suitable for delivering CRLs for broadcast application authentication as: 

• not all MHP profiles require return channel support 

• MHP terminals may be able to receive broadcast applications when not connected to a return channel 

• it would not be acceptable to require a return charmel session to authenticate each broadcast application 

12.9.1.2.2 Distribution via MPEG stream 

For an MHP terminal without a working return channel, the only way to deliver CRLs is via the broadcast MPEG 
Transport Stream. 

12.9.1.3 CRL retention 

12.9.1.3.1 Requirement 

MHP terminals shall retain CRLs or the information they contain (including serial numbers) in persistent storage 
because: 

• this enhances security as it defends against attacks with signals that filter out the CRL and use a revoked 
certificate 

• it is more efficient to cache CRLs rather than downloading the CRLs for authentication of each application 

12.9.1.3.2 Storage requirement 

The minimum amount of persistent storage required to store CRLs is addressed in 12.12, "Platform minima" on 
page 196. 

12.9.1.3.3 Storage management 

The broadcast CRL and RCMM signalling (see 12.9.2, "Root certificate management" on page 183) manages the use of 
the persistent storage. 

If the CRL of a non-root certificate CA become's too large the CA's certificate itself can be revoked by its parent CA who 
adds it to their CRL. For root certificates, the RCMM mechanism can be used. 

12.9.1 .4 CRL file location and naming convention 

For CRLs that are authenticated by a broadcast certificate the format of the name of files carrying CRLs shall be: 

"dvb . crl . x" 

In this case the "x" portion of the filename corresponds to the "x" portion of a certificate filename for the certificate file 
that authenticates the CRL. 

For CRLs that are authenticated by a root certificate the format of the name of files carrying CRLs shall be: 

"dvb . crl . root . x" 

In this case the "x" portion of the filename is just a discriminator to ensure non-collision of CRL file names in the event 
that there is more than one in this directory. 

The CRL filename may not be constant through time or across broadcasts. So, implementations shall not rely on this 
filename when caching the CRL. 
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All CRL files shall be located in a subdirectory of the root of the file system called "dvb.crl". The location of certificate 
files authenticating the CRL files shall follow the same rules as for the location of certificates relative to a signature file. 
That is the certificate files shall either be in the dvb.crl directory or in the root directory. Seel2.4.3.5, "CertificateFile 
location and naming conventions" on page 159. 

12.9.1.5 Operational model 

Receivers are expected to inspect the set of CRL files periodically and cache the revocation information for future use. 
This inspection process can assume that a file system will not normally carry certificates revoked by CRL files carried in 
the same file system. So, inspection of the CRL set in a file system is not a precondition to authenticating other files in 
that file system. 

This specification does not address the reliability with which implementations are required to consider certificate 
revocations when authenticating files. 

12.9.1.6 Examples 

12.9.1.6.1 Revocation of a broadcaster's certificate 
If the broadcaster B's certificate is compromised: 

a) the certification authority CAOl adds the serial number of broadcaster B's certificate to its CRL 

b) C AO 1 then sends the new CRL file to the broadcasters that use C AO 1 

c) these broadcasters (broadcaster A for instance) broadcast the new CRL file 

As soon as an MHP terminal has downloaded the new CRL file (after selecting one of broadcaster A's channel), the MHP 
terminal's CRL cache in persistent storage is updated. The MHP terminal is then protected against any malicious usage of 
the compromised certificate. 

To continue authenticating applications broadcast "B" will require a new certificate. 

1 2.9. 1 .6.2 Revocation of a CA's certificate. 

If the CRL of CAOl becomes too big, CAOl's certificate could be revoked: 

a) the root certification authority RCAO adds the serial number of CAOl's certificate to its CRL 

b) RCAO sends the new CRL file to the broadcasters that use RCAO 

c) these broadcasters broadcast the new CRL file 

As soon as an MHP terminal has downloaded the new CRL file, its CRL cache in persistent storage for RCAO is updated 
and CAOl's CRL is removed from the cache (as CAOl has been revoked). 

12.9.1.7 CRL format 

Each CRL file contains the CRL of one certification authority. 

The encoding of the CRL is defined in the ITU-T X.509 [54] is reproduced below for information. The fields Version, 
Time, CertificateSerialNumber correspond to fields with the same names in the certificate see 12.11, "The internet profile 
of X.509 (informative)" on page 188: 

CertificateList ::= SEQUENCE { 

tbsCertList TBSCertList, 

signatureAlgorithm Algorithmldentif ier , 

signatureValue BIT STRING } 

TBSCertList ::= SEQUENCE { 

version Version OPTIONAL, 

— if present, shall be v2 

signature Algorithmldentif ier, 

issuer Name, 

thisUpdate Time, 

nextUpdate Time OPTIONAL, 

revokedCertificates SEQUENCE OF SEQUENCE { 
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userCertif icate 
revocationDate 

crlEntryExt ens ions 

} OPTIONAL, 
orlExtensions 



Certif icateSerialNumber , 

Time, 

Extensions OPTIONAL 

— if present, shall be v2 

[0] EXPLICIT Extensions OPTIONAL 

— if present, shall be v2 



12.9.1.8 



Profile of CRL 



The profile of fields that correspond to fields in the certificate follow the profile in 12.5, "Profile of X.509 certificates for 
authentication of applications" on page 161. This applies to the following fields: 

signatureAlgorithm : follows "signature Algorithm" on page 161. 

signatureValue: follows "signature Value" on page 161. 

version: follows "version" on page 161. 

signature: follows "signatureAlgorithm" on page 161. 

issuer: follows "issuer" on page 161. 

thisUpdate: Publication date of this CRL. Follows the encoding of Time used for validity. See "validity" on page 162. 

nextUpdate: Publication date of the next version of the CRL. Follows the encoding of Time used for validity. See 
"validity" on page 162. 

userCertiflcate: SerialNumber of the revoked certificate. It is used to identify the revoked certificate. 
The serial number shall be unique for a given CA. So, the pair [issuerName, serialNumber] shall be unique. 

revocationDate: Date of revocation for a given certificate. Follows the encoding of Time used for validity. See 
"validity" on page 162. 

crIExtensions: The syntax of the Extensions element is reproduced on "Extensions" on page 192. This element allows 
multiple extension elements to be carried. The set of extensions defined for certificates and CRLs is reproduced at 12.1 1. 
2, "Standard certificate extensions" on page 193. 

The following crlExtension shall be supported: 

• AuthorityKeyldentifier as defined in section 12.4.2.1 on page 157. 

This extension identifies the certificate that is needed to check the signature of the CRL. 

The crlExtension AuthorityKeyldentifier shall be included in every CRL. MHP implementations shall 
use the AuthorityKeyldentifier to find the certificate that carries the public key that is used to check the 
signature of the CRL and ignore any CRLs where this check fails or where the AuthorityKeyldentifier is not 
present. 

Other crIExtensions are optional. 

12.9.1.9 CRL Processing 

CRLs, or the information they contain (including serial numbers), shall be kept in persistent storage in the MHP terminal. 
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When an MHP terminal finds a file with the file name format given in 12.4.3.5, "CertificateFile location and naming 
conventions" on page 159, it shall do the fiallowing sequence: 

a) Get the field thisUpdate and compare it with the last update for the CRL. If thisUpdate is not after the last update, 
ignore the CRL. 

b) The signature of the CRL is verified and the signing certificate is verified to be from a trusted source. If the 
certificate cannot be trusted, the CRL is ignored. 

c) Process the content of the CRL message: 

- store the list of serial numbers of revoked certificates in persistent storage. 

- update the stored value of thisUpdate with the value from the CRL. 

d) If a CA's certificate has been revoked, remove its CRL (or the information which that CRL contained) if it was 
stored in the MHP terminal. 

During the validation process of a certificate chain, the CRL of each certification authority on the certification path is 
checked. 

12.9.2 Root certificate management 

12.9.2.1 Introduction 

Every compliant MHP terminal will have to maintain a set of X. 509 root certificates in persistent storage. These root 
certificates will be placed in the MHP terminal by its manufacturer during the manufacturing process. 

It could be necessary to update the set of root certificates for MHP terminals that are already deployed. Possible reasons 
that could require such an update include: 

• a root certificate becoming compromised 

• technical developments (such as the emergence of factorisation algorithms) that require the use of greater key 
lengths in root certificates to provide adequate security 

• retirement of a certificate due to its age 

So, It is necessary to have a standard mechanism to update this set. 

NOTE: A manufacturer specific mechanism could require a different message for each manufacturer and so 
would be more expensive in terms of broadcast bandwidth. 

The mechanism specified here uses messages called RCMM (Root Certificate Management Messages). These messages 
contain a set of new root certificates to add and a reference to the root certificates to remove. 

1 2.9.2.2 Security of RCMM 

RCMM are authenticated by multiple signatures. An RCMM message will be accepted by an MHP terminal if and only if 
it has at least N signatures. 

The initial value of N and the maximum value of N that MHP terminals will ever be asked to support are specified in 12. 
12, "Platform minima" on page 196. 

The use of multiple signatures guarantees that the set of root certificates can be updated securely even if one of the root 
certificates has been compromised. 

RCMM can update the number of signatures required for future RCMM using the nextNbOfSignature field. 

The RCMM message shall be signed with the key of the certificates to be removed. 
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12.9.2.3 



Format of RCMM 



The encoding of RCMM is ASN.l DER (see ASN.l [57]): 



URCMM ::= SEQUENCE { 
issuer 
thisUpdate 
nextNbOf Signatures 
addedCertif icates 
removedCertif icates 

Certif icatesRef erence : : 

issuerName 
serialNumber 



SEQUENCE { 



Name, 

Time, 

INTEGER OPTIONAL, 

SET OF Certificate 

SET OF CertificatesReference 



Name, 

Certif icateSerialNumber } 



issuer: Identification of the certification authority which has issued the message. 

thisUpdate: Date of the issue of the message. 

nextNbOfSignatures: This field could be used to change the minimum number of valid signatures required for an 
RCMM message. This value will be applied to the next RCMMs not to itself! 

addedCertiflcates: List of root certificates to be added in persistent storage 

removedCertificates: Reference of the root certificates to be removed from persistent storage 



RCMM : := SEQUENCE { 
uRcmm 
signatures 

Signaturelnfo ::= SEQUENCE { 
signerName 
signatureAlgorithm 
signatureValue 



URCMM, 

SET OF Signaturelnfo 



Name, 

Algorithmldentif ier , 
BIT STRING } 



NB: The signatures are computed on the whole content of uRCMM. 

issuerName: Name of the issuer of the root certificate to remove (for a self signed root certificate this field is equal to 
the subject name). 

serialNumber: Serial number of the root certificate to remove. 

12.9.2.4 Distribution of RCMM 

RCMM are distributed to the MHP terminals in the broadcast MPEG Transport Stream. The RCMM from a particular 
CA are supplied to at least the broadcasters that use that CA. 

The most recent RCMM shall be placed in a file named: 

"dvb . rcmm" 

The RCMM files are inserted on a sample basis specified by the CA. These files shall be located in root directories of the 
object carousels broadcast. 

Older RCMMs shall be placed in files named " dvb . rcmm . " <x> where x is a textual representation of an integer 
decimal number without leading zeroes. The range of values represented in any single directory shall start with 1 and 
increment in steps of l.The first unused integer value in the ascending sequence indicates the end of the range. RCMMs 
shall be sorted in chronological order with the oldest RCMM in dvb . rcmm . 1. The RCMM signalled as "dvb . rcmm" 
shall not be duplicated in the " dvb . rcmm . " <x> sequence. 
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12.9.2.5 RCMM Processing 

When an MHP terminal finds RCMM messages in a root directory, it shall perform the following sequence of operations: 

a) If there has never been any RCMM processing (last update to be stored in the receiver not initialised), then 
process sequentially according to steps (b) to (j) all dvb . rcmm . <x> messages in ascending order including the 
dvb . rcmm message as the final step. Otherwise, identify the dvb . rcmm . <x> message whose field thisUpdate 
is the closest after the last update and process sequentially according to steps (b) to (j) all following dvb . rcmm . 
<x> in ascending order including the dvb . rcmm message as the final step. If the field thisUpdate from the dvb . 
rcmm message is not after the last update, ignore the messages. 

For each RCMM message identified in step (a), perform the following: 

b) If there is a nextNbOfSignatures in the RCMM, and if nextNbOfSignatures will be greater than the number of 
remaining root CAs (i.e. the number of root CA that would remain if the RCMM was processed), ignore the 
RCMM. 

c) Get the number signatures from the RCMM, if this number is lower than the minimum required, ignore the 
message. 

d) If the RCMM contains references to root certificates to remove, check this RCMM is signed with the keys 
belonging to the certificates to be removed. If at least one of these signatures is missing, ignore the RCMM 
message. 

e) Check all the signatures of the RCMM. If any of the signatures is invalid, ignore the message. 

f) Process the content of the RCMM message, add and remove root certificates according to the RCMM message. 

g) Store in persistent storage the date of thisUpdate as the date of the last update. 

h) If a root certificate is removed, the CRLs associated are also removed. 

i) If there is a nextNbOfSignatures in the RCMM, replace the minimum number of signature required by the 
nextNbOfSignatures. 

j) Since this process will permanently modify the terminal behaviour and is highly sensitive for security, this is 
allowed to have an implementation dependent enabling / confirmation step prior to performing the action (e.g. it 
may prompt the end user for verification). Such an enabling / confirmation step is allowed to reject this RCMM 
action. 

The implementation shall ensure the following: 

• The integrity of the persistent storage shall be kept if the power supply fails for any reason during the processing 
of any RCMM message in a dvb . rcmm . <x> file or the dvb . rcmm file. i.e. If the power is switched off during 
the processing of the RCMM message, the set of root certificates shall remain as if processing of that RCMM 
message had not started. 

i.e. If the power is switched off during the processing of the RCMM message, the set of root certificates shall 
remain as if processing of the RCMM message had not started. 

• The minimum amount of persistent storage reserved to store the list of root certificate is specified in 12.12, 
"Platform minima" on page 196. If there is not enough persistent storage available to process an RCMM message, 
it shall be ignored (to prevent inconsistencies). 

NOTE: This specification is intentionally silent about the impact of RCMM processing on MHP 
applications which are already running. 
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12.9.2.6 Example: Renewal of a root certificate 

Let's assume the root certification authority RCA has two certificates in each MHP temininal:RCO and RCl. If RCO is 
compromised, RCA may wish to renew this certificate using the following steps: 

a) RCA generates a new key pair and a new self signed certificate RC2. 

b) RCA provides new certificates signed by RC 1 to all the entities authenticated by RCA. 

c) Wait until all entities authenticated by RCA have switched to the new certificates and have stopped using RCO. 

d) RCA generates an RCMM message to add RC2 and to remove RCO. This RCMM will be double signed by RCO 
and RCl keys. 

e) RCA will delivers this RCMM message to the broadcasters to update the MHP terminals. 

(The broadcasting period should be long enough to update almost all of the MHP terminals in the field). 

f) RCA will provide RC 1 and RC2 to set top box manufacturers as the new list of root certificates to put in set top 
boxes. 

12.9.3 Test certificates 

There shall be a means to make test root certificates (as required by 12.12, "Platform minima" on page 196) available 
while the terminal is being tested. The method for doing so shall be implementation dependent; it may involve either 
replacing non-test root certificates, or storing test root certificates in addition to non-test root certificates. 

Test root certificates shall only be functional when the terminal is being tested. Objects signed with test root certificates 
shall not be used other than for the purposes of testing. 

This specification is intentionally silent on the test root certificates to be used. 

12.10 Security on the return channel 

General purpose security for the return channel is provided by the TLS (Transport Layer Security) protocol as described 
in IETF RFC 2246 [63]. 

12.10.1 MHP functionality 

When implementing return channel security the MHP shall: 

• implement the cipher suites identified in section 12.10.2 
The MHP is not required to implement the following: 

• the functionality of being a server for the TLS protocol 

• compliance with SSL 3.0 

• TLS client authentication 

12.10.2 TLS cipher suites 

The minimum set of cypher tools that implementations of the MHP profile of TLS shall implement are: 

• RSA 

• MD5 

• SHA-1 

• DBS 



ETSI 



187 



ETSITS 101 812V1.3.1 (2003-06) 



More detail of this requirement is given in table 60 (see IETF RFC 2246 [63] for definition of the terms) which identifies 
which methods are required in an MHP. 

Table 60 : Profile of cipher suites that implementations are required to support 



CipherSuite 


Key 
Exchange 


Cipher 


Hash 


Valu 

e 
(hex) 


MHP 
status 


TLS_NULLWITH_NULL_NULL (note 1) 


NULL 


NULL 


NULL 


00,00 


Required 


TLS_RSA_WITH_NULL_MD5 


RSA 


NULL 


MD5 


00,01 


Required 


TLS_RSA_WITH_NULL_SHA 


RSA 


NULL 


SHA-1 


00,02 


Required 


TLS_RSA_EXPORT_WITH_DES40_CBC_SHA 


RSA_ 
EXPORT 


DES40_CBC 


SHA-1 


00,08 


Required 


TLS_RSA_WITH_DES_CBC_SHA 


RSA 


DES_CBC 


SHA-1 


00,09 


Required 


TLS_RSA„WITH_3DES_EDE_CBC_SHA 


RSA 


3DES_EDE_CBC 


SHA-1 


00, OA 


Required 


NOTE 1 : This cipher suite is only used by a TLS implementation during the negotiation of a connection. It is not 
required to be enabled as a cipher suite that is available for a negotiated connection. 



NOTE: The ciphers TLS_RSA_WITH_NULL_MD5 and TLS_RSA_WITH_NULL_SHA provide 

integrity checking but without confidentiality (i.e. data are in clear). Data encryption is very time 
consuming for a server. They are useful for applications in which data don't need to be encrypted 
but in which data integrity is very important. For these applications, the server will only have to 
compute a HMAC for every message exchanged. 

12.10.3 Downloading of certificates for TLS 

12.10.3.1 Introduction 

Before the TLS connection can be established, the MHP has to ensure that the certificate list sent by a server contains at 
least one trusted certificate. In computer environment, this is simply done by checking the list of certificates against one 
certificate that is resident in the computer. 

In the MHP environment, a downloadable application can establish a TLS session. This can be used for e.g. sensitive 
transactions. In such a scenario, the application knows which server to connect to, and also knows one certificate against 
which it can check that a given certificate chain contains the expected certificate that it knows and trusts. 

The API that is used by a downloadable application is described in section 1 1.8.2, "APIs for return channel security" on 
page 139. The process of server authentication involves the checking of the certificate chain sent by the TLS server. 

This section specifies how the MHP terminal identifies and manages the TLS certificates that are downloaded along with 
the application and how verification (or otherwise) is presented to the application). 

12.10.3.2 Usage of certificate in TLS 

12.10.3.2.1 When certificates are delivered with the application 

One or several TLS root certificates can be optionally broadcast along with the application. 

When the certificate chain sent by the TLS server is not compatible with any of the TLS root certificates sent with the 
application an lOException will be thrown. 

12.10.3.2.1.1 Certificate file naming and location 

To facilitate certificate chain checking the name of the certificate file shall be: 

dvb . tls . organisation_id. application_id. x 



ETSI 



188 



ETSITS 101 812V1.3.1 (2003-06) 



where: 



"x" is an optional string discriminating certificates where necessary. 



• the encoding of organi3ation_id and appiication_id are Specified in 14.5, "Text encoding of application 
identifiers" on page 222. 

Location of the TLS certificates is application type dependant. See table 61. 

Table 61 : TLS certificate locator semantics 



application_type 


description 


0x0000 


reserved 


0x0001 


For DVB-J the TLS certificate(s) are placed in the base 
directory of the application as defined in 10.9.2, "DVB-J 
application location descriptor" on page 98. 


0x0002 


For DVB-HTML the TLS certificate(s) are placed at the 
physical root of the application as defined in 10.10.2, 
"DVB-HTML application location descriptor" on page 100. 


0x0003... OxFFFF 


reserved for future use 



12.10.3.2.1.2 



Certificate authentication 



To be considered valid TLS certificates the certificate files shall be authenticated members of the same authenticated sub- 
tree as the application. 



12.10.3.2.1.3 



Certificate file format 



Each TLS certificate file contains a single certificate. The file format is the same as that used by certificate files for 
application authentication, see 12.4.3, "CertificateFile" on page 159. 

12.10.3.2.2 When no certificates are provided 

When there are no TLS certificates sent with the application then the implementation will allow connection to be 
established to any server. The application can then use the JSSE API (see 1 1.8.2 on page 139) to retrieve the certificate 
chain and check that it contains what the application requires. In such a case both name and public keys need to be 
checked by the application if the application wants to be sure of the remote server. 

12.10.3.2.3 CRL distribution points 

MHP implementations are free to ignore this field during TLS server authentication over the return channel. 

12.11 The internet profile of X.509 (informative) 

The text that follows summarises the technical features of IETF RFC 2459 [58] and references the different profile 
decisions made for the different MHP application areas. 

12.11.1 Main part of the certificate 

12.11.1.1 Certificate 

Certificate ::= sequence { 

tbsCertificate TBSCertif icate, 

signatureAlgorithm Algorithmldentif ier , 

signatureValue BIT STRING } 

12.11.1.2 signatureAlgorithm 

The signatureAlgorithm field contains the identifier for the cryptographic algorithm used by the CA to sign this 
certificate. 
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An algorithm identifier is defined by the following ASN. 1 structure: 

Algorithmldentifier ::= sequence { 

algorithm OBJECT IDENTIFIER, 

parameters ANY DEFINED BY algorithm OPTIONAL } 

The algorithm identifier is used to identify a cryptographic algorithm. The OBJECT IDENTIFIER component identifies 
the algorithm. The contents of the optional parameters field will vary according to the algorithm identified. 

This field MUST contain the same algorithm identifier as the signature field in the sequence TBSCertificate. 

See 12.5.1, "signatureAlgorithm" on page 161. 

NOTE: IETF RFC 2459 [58] section 7.2 lists the signature algorithms supported by that profile. 
For all of the currently specified algorithms possible non-NULL parameters shall be ignored. 

12.11.1.3 signatureValue 

The signatureValue field contains a digital signature computed upon the ASN. 1 DER encoded tbsCertificate. The ASN. 1 
DER encoded tbsCertificate is used as the input to the signature function. This signature value is then ASN. 1 encoded as 
a BIT STRING and included in the Certificate's signature field. 

NOTE: IETF RFC 2459 [58] section 7.2 describes in detail this process for the algorithms supported by 
that profile. 

By generating this signature, a CA certifies the validity of the information in the tbsCertificate field. In particular, the CA 
certifies the binding between the public key material and the subject of the certificate. 

See 12.5.2, "signatureValue" on page 161. 

12.11.1.4 tbsCertificate 

The field contains the names of the subject and issuer, a public key associated with the subject, a validity period, and 
other associated information. The tbscertificate may also include extensions. 

The pair issuer / serialNumber uniquely identifies the certificate. 

TBSCertificate ::= sequence { 

version [0] EXPLICIT Version DEFAULT vl, 

serialNumber Certif icateSerialNumber , 

signature Algorithmldentifier, 

issuer Name, 

validity Validity, 

subject Name, 

sub jectPubl icKey Info Sub jectPublicKey Info, 

issuerUniquelD [1] IMPLICIT Uniqueldentif ier OPTIONAL, 

— If present, version shall be v2 or v3 
subjectUniquelD [2] IMPLICIT Uniqueldentif ier OPTIONAL, 

— If present, version shall be v2 or v3 
extensions [3] EXPLICIT Extensions OPTIONAL 

— If present, version shall be v3 } 

12.11.1.5 version 

This field describes the version of the encoded certificate. When extensions are used, as expected in this profile, use X. 
509 version 3 (value is 2). If no extensions are present, but a Uniqueldentifier is present, use version 2 (value is 1). If only 
basic fields are present, use version 1 (the value is omitted from the certificate as the default value). 

Implementations SHOULD be prepared to accept any version certificate. At a minimum, conforming implementations 
MUST recognize version 3 certificates. 

Version ::= integer { vl(0), v2(l), v3(2) } 

Generation of version 2 certificates is not expected by implementations based on this profile. 

See 12.5.3, "version" on page 161. 
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12.11.1.6 serialNumber 

The serial number is an integer assigned by the CA to each certificate. It MUST be unique for each certificate issued by a 
given CA (i.e., the issuer name and serial number identify a unique certificate). 

CertificateSerialNuitiber ::= integer 

12.11.1.7 signature 

This field contains the algorithm identifier for the algorithm used by the CA to sign the certificate. 

This field MUST contain the same algorithm identifier as the signatureAlgorithm field in the sequence Certificate. The 
contents of the optional parameters field will vary according to the algorithm identified. 

If the signatureAlgorithm is different from the algorithm identifier in the signature field, the signature shall be rejected as 
being inconsistent. 

See 12.5.1, "signatureAlgorithm" on page 161. 

NOTE: IETF RFC 2459 [58] section 7.2 lists the supported signature algorithms for that profile. 

12.11.1.8 issuer 

The issuer field identifies the entity who has signed and issued the certificate. The issuer field MUST contain a non- 
empty distinguished name (DN). The issuer field is defined as the X.501 type Name. ITU-T X.501 [53] Name is defined 
by the following ASN.l structures: 

Name: := choice { 

RDNSequence } 
RDNSequence : : = sequence of RelativeDistinguishedName 

RelativeDistinguishedName: := 

set of AttributeTypeAndValue 

AttributeTypeAndValue : : = sequence { 
type AttributeType, 

value AttributeValue } 

AttributeType :: = object identifier 

AttributeValue :: = any defined by AttributeType 

DirectoryString: := choice { 

teletexString TeletexString (SIZE (1..MAX)), 

printableString PrintableString (SIZE (1..MAX)), 

universalString OniversalString (SIZE (1..MAX)), 

utfSString OTFSString (SIZE (1.. MAX)), 

bmpString BMPString (SIZE (1..MAX)) } 

The Name describes a hierarchical name composed of attributes, such as country name, and corresponding values, such 
as US. The type of the component AttributeValue is determined by the AttributeType; in general it will be a 
DirectoryString. 

See 12.5.4, "issuer" on page 161. 

12.11.1.9 validity 

The certificate validity period is the time interval during which the CA warrants that it will maintain information about 
the status of the certificate. The field is represented as a SEQUENCE of two dates: the date on which the certificate 
validity period begins notBefore) and the date on which the certificate validity period ends (notAfter). Both notBefore 
and notAfter may be encoded as UTCTime or GeneralizedTime. 

CAs conforming to this profile MUST always encode certificate validity dates through the year 2049 as UTCTime; 
certificate validity dates in 2050 or later MUST be encoded as GeneralizedTime. 
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Validity: := sequence { 

notBefore Time, 
notAfter Time } 

Time: := CHOICE { 

utcTime UTCTime, 
generalTime GeneralizedTime } 

A non-root certificate validity is limited by the validity period of the signer's certificate. 

12.11.1.9.1 UTCTime 

The universal time type, UTCTime, is a standard ASN. 1 type intended for representation of dates and time. UTCTime 
specifies the year through the two low order digits and time is specified to the precision of one minute or one second. 
UTCTime includes either Z (for Zulu, or Greenwich Mean Time) or a time differential. 

For the purposes of this profile, UTCTime values MUST be expressed Greenwich Mean Time (Zulu) and MUST include 
seconds (i.e., times are YYMMDDHHMMSSZ), even where the number of seconds is zero. Conforming systems MUST 
interpret the year field (YY) as follows: 

• Where YY is greater than or equal to 50, the year shall be interpreted as 19YY; and 

• Where YY is less than 50, the year shall be interpreted as 20 YY. 

12.11.1.9.2 GeneralizedTime 

The generalized time type, GeneralizedTime, is a standard ASN. 1 type for variable precision representation of time. 
Optionally, the GeneralizedTime field can include a representation of the time differential between local and Greenwich 
Mean Time. 

For the purposes of this profile, GeneralizedTime values MUST be expressed Greenwich Mean Time (Zulu) and MUST 
include seconds (i.e., times are YYYYMMDDHHMMSSZ), even where the number of seconds is zero. GeneralizedTime 
values MUST NOT include fractional seconds. 

See 12.5.5, "validity" on page 162. 

12.11.1.10 subject 

The subject field identifies the entity associated with the public key stored in the SubjectPublicKeylnfo field. It 
thus represents the entity whose public key is certified. It is encoded as a Distinguished Name (see "issuer" on 
page 190). This name must be unique for each subject entity certified by one CA as defined by the issuer field. 

12.11.1.10.1 issuerUniquelD 

This field is optional and appears in X.509 v2 or v3 only. It enables to reuse the IssuerName over time. It is redundant 
with the issuer Name, and it is proposed here that this field be not parsed by the client. 

12.11.1.10.2 subjectUniquelD 

This field is optional and appears in X.509 v2 or v3 only. It enables to reuse the subjectName over time. It is redundant 
with the subject Name, and it is proposed here not to use this field. 

The subject name may be carried in the subject field and/or the subject AltName extension. If the subject is a CA (e.g., the 
basic constraints extension, as discussed in IETF RFC 2459 [58] section 4.2.1.10, is present and the value of cA is 
TRUE,) then the subject field MUST be populated with a non-empty distinguished name matching the contents of the 
issuer field (see IETF RFC 2459 [58] section 4.1.2.4) in all certificates issued by the subject CA. If subject naming 
information is present only in the subject AltName extension (e.g., a key bound only to an email address or URI), then the 
subject name MUST be an empty sequence and the subject AltName extension MUST be critical. 

Where it is non-empty, the subject field MUST contain an X.500 distinguished name (DN). The DN MUST be unique for 
each subject entity certified by the one CA as defined by the issuer name field. A CA may issue more than one certificate 
with the same DN to the same subject entity. 



ETSI 



192 ETSITS 101 812V1.3.1 (2003-06) 



The subject name field is defined as the X.501 type Name. Implementation requirements for this field are those defined 
for the issuer field (see IETF RFC 2459 [58] section 4.1.2.4). When encoding attribute values of type DirectoryString, 
the encoding rules for the issuer field MUST be implemented. Implementations of this specification MUST be prepared 
to receive subject names containing the attribute types required for the issuer field. Implementations of this specification 
SHOULD be prepared to receive subject names containing the recommended attribute types for the issuer field. The 
syntax and associated object identifiers (OIDs) for these attribute types are provided in the ASN.l modules in 
IETF RFC 2459 [58] Appendices A and B. Implementations of this specification MAY use these comparison rules to 
process unfamiliar attribute types (i.e., for name chaining). This allows implementations to process certificates with 
unfamiliar attributes in the subject name. 

In addition, legacy implementations exist where an RFC 822 name is embedded in the subject distinguished name as an 
EmailAddress attribute. The attribute value for EmailAddress is of type IA5 String to permit inclusion of the 
character '@', which is not part of the PrintableString character set. EmailAddress attribute values are not case sensitive 
(e.g., "fanfeedback@redsox.com" is the same as "FANFEEDBACK@REDS0X.COM"). 

Conforming implementations generating new certificates with electronic mail addresses MUST use the rfc822Name in 
the subject alternative name field (see IETF RFC 2459 [58] section 4.2.1.7) to describe such identities. Simultaneous 
inclusion of the EmailAddress attribute in the subject distinguished name to support legacy implementations is 
deprecated but permitted. 

12.11.1.11 SubjectPublic Key Info 

This field is used to carry the public key which is certified and identifies the algorithm with which the key is used. The 
algorithm is identified using the Algorithmldentifier structure (see "signature Algorithm" on page 188) and the public key 
is represented as a bitstring. 

SubjectPublicKeylnfo ::= sequence { 

algorithm Algorithmldentifier, 

subjectPublicKey BIT STRING } 

See 12.5.7, "SubjectPublic Key Info" on page 162. 

NOTE: IETF RFC 2459 [58] section 7.3 lists the supported algorithms for that profile. 

12.11.1.12 Unique Identifiers 

These fields may only appear if the version is 2 or 3. The subject and issuer unique identifiers are present in the certificate 
to handle the possibility of reuse of subject and/or issuer names over time. This profile recommends that names not be 
reused for different entities and that Internet certificates not make use of unique identifiers. CAs conforming to this 
profile SHOULD NOT generate certificates with unique identifiers. Applications conforming to this profile SHOULD be 
capable of parsing unique identifiers and making comparisons. 

Uniqueldentifier ::= bit string 
See 12.5.8, "Unique Identifiers" on page 163. 

12.11.1.13 Extensions 

This field may only appear if the version is 3 and is optional. If present, this field is a SEQUENCE of one or more 
certificate extensions. 

Extensions : := SEQUENCE SIZE {1..MAX) OF Extension 

Extension ::= sequence { 

extnID OBJECT IDENTIFIER, 
critical BOOLEAN DEFAULT FALSE, 
extnValue OCTET STRING } 

The extensions are defined in ITU-T X.509 [54]. 
See 12.5.9, "Extensions" on page 163. 
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12.1 1.2 Standard certificate extensions 

See table 52, "Profile for standard certificate extensions" on page 163. 

12.11.2.1 Authority key identifier 

This extension is used where an issuer has multiple signing keys. It provides a means of finding the public key that can be 
used to check the signature of the certificate. 

The identification can be based on either the keyldentifier or the on the pair (authorityCertlssuer, 
AuthorityCertSerialNumber). It is recommended to use the pair (authorityCertlssuer, AuthorityCertSerialNumber) 
instead of the keyldentifier because there is no common agreement on the way to compute a unique Keyldentifier. 

AuthorityKeyldentif ier ::= SEQUENCE { 

keyldentifier [0] Keyldentifier OPTIONAL, 

authorityCertlssuer [1] GeneralNames OPTIONAL, 

authorityCertSerialNumber [2] Certif icateSerialNumber OPTIONAL } 

12.11.2.2 Subject key identifier 

This extension provides of identifying certificates that contain a particular public key. 

Sub jectKeyldentif ier ::= Keyldentifier 

12.11.2.3 Key usage 

The key usage extension defines the purpose of the key contained in the certificate. 

keyUsage ::= BIT STRING { 

digitalSignature (0) 

nonRepudiation (1) 

keyEncipherment (2) 

dataEncipherment (3) 

keyAgreement (4) 

keyCertSign (5) 

cRLSign (6) 

encipherOnly (7) 

decipherOnly (8) 
} 

12.11.2.4 Private key usage period 

This field is used to defined a period of validity for the private key which is different from the period of validity of the 
certificate. This is only meaningful for digital signature keys. 

privateKeyUsagePeriod EXTENSION : := { 
SYNTAX PrivateKeyUsagePeriod 
IDENTIFIED BY id-ce-privateKeyUsagePeriod } 

PrivateKeyUsagePeriod ::= SEQUENCE { 

notBefore [0] GeneralizedTime OPTIONAL, 
notAfter [1] GeneralizedTime OPTIONAL } 

( WITH COMPONENTS {..., notBefore PRESENT} 
WITH COMPONENTS {..., notAfter PRESENT} ) 

12.1 1 .2.5 Certificate policies 

This field is used to define a policy defining the purpose for which the certificate may be used. 

Applications may have a list of specific policies they will accept, the certificate validation software must be able to 
compare the policy OIDs found in the certificate to that list. 

certif icatePolicies EXTENSION ::= { 

SYNTAX Certif icatePoliciesSyntax 

IDENTIFIED BY id-ce-cert if icatePolicies } 
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CertificatePoliciesSyntax ::= SEQUENCE SIZE (1..MAX) OF Policyinf ormation 

Policylnformation ::= SEQUENCE { 
policyldentif ier CertPolicyld, 
policyQualifiers SEQUENCE SIZE (1..MAX) OF 

PolicyQualifierlnfo OPTIONAL } 

CertPolicyld ::= OBJECT IDENTIFIER 

PolicyQualifierlnfo ::= SEQUENCE { 

policyQualif ierld CERT-POLICY-QUALIFIER. Sid 

( { Support edPolicyQual if ier s } ) , 
qualifier CERT-POLICY-QUALIFIER. SQualif ier 

( { Support edPolicyQual if ier s } { @policyQual if ierld} ) 
OPTIONAL } 

SupportedPolicyQualifiers CERT-POLICY-QUALIFIER ::= { ... } 

12. 11 .2.6 Policy mappings 

This field is used to define equivalence between policies from different CA's policy Domain. 

policyMappings EXTENSION ::= { 

SYNTAX PolicyMappingsSyntax 

IDENTIFIED BY id-ce-policyMappings } 

PolicyMappingsSyntax ::= SEQUENCE SIZE (1..MAX) OF SEQUENCE { 
issuerDomainPolicy CertPolicyld, 
sub jectDomainPolicy CertPolicyld } 

12.11 .2.7 Subject Alternative Name 

This field is used to define additional identities fiar the subject name of the certificate (such as an internet email address). 

subjectAltName EXTENSION ::= { 
SYNTAX GeneralNames 
IDENTIFIED BY id-ce-sub jectAltName } 

GeneralNames ::= SEQUENCE SIZE (1..MAX) OF GeneralName 

GeneralName ::= CHOICE { 

otherName [0] INSTANCE OF OTHER-NAME, 

rfc822Name [1] lASString, 

dNSName [2] lASString, 

x400Address [3] ORAddress, 

directoryName [4] Name, 

ediPartyName [5] EDIPartyName, 

unif ormResourceldentif ier [6] IA5String, 

iPAddress [7] OCTET STRING, 

registeredID [8] OBJECT IDENTIFIER } 

12.11.2.8 Issuer Alternative Name 

This field is similar to the previous one for the issuer identity. 

issuerAltName EXTENSION ::= { 
SYNTAX GeneralNames 

IDENTIFIED BY Id-ce-issuerAltName } 

12.11.2.9 Subject Directory attributes 

This field is used to carry optional directory attributes associated with the subject. 

subjectDirectoryAttributes EXTENSION : := { 
SYNTAX AttributesSyntax 
IDENTIFIED BY id-ce-sub jectDirectoryAttributes } 

AttributesSyntax ::= SEQUENCE SIZE (1..MAX) OF Attribute 
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12.11.2.10 Basic Constraints 

This field indicates if the subject of the certificate is a certification authority and how deep a certification path may exist 
through that path. 

This extension shall appear in every CA Certificates. It will be used to prevent unauthorised entities to act as a CA. 

basicConstraints EXTENSION ::= { 

SYNTAX BasicConstraintsSyntax 
IDENTIFIED BY id-ce-basicConstraint s } 

BasicConstraintsSyntax : := SEQUENCE { 

cA BOOLEAN DEFAULT FALSE, 

pathLenConstraint INTEGER (O..MAX) OPTIONAL } 

12.11.2.11 Name Constraints 

This field indicates a namespace within which all subject names in subsequent certificates in a certification path shall be 
located. 

nameConstraints EXTENSION ::= { 

SYNTAX NameConstraintsSyntax 
IDENTIFIED BY id-ce-nameConstraint s } 

NameConstraintsSyntax ::= SEQUENCE { 

permittedSubtrees [0] GeneralSubtrees OPTIONAL, 

excludedSubtrees [1] GeneralSubtrees OPTIONAL } 

GeneralSubtrees ::= SEQUENCE SIZE (1..MAX) OF GeneralSubtree 

GeneralSubtree ::= SEQUENCE { 

base GeneralName, 

minimum [0] BaseDistance DEFAULT 0, 

maximum [1] BaseDistance OPTIONAL } 

BaseDistance ::= INTEGER (O..MAX) 

12.11.2.12 Policy Constraints 

This field is only used in CA's certificate (i.e. not in end entity certificate). It is used to prohibit policy mapping or to 
require that each certificate in a path contain an acceptable policy identifier. 

policyConstraints EXTENSION ::= { 

SYNTAX PolicyConstraintsSyntax 
IDENTIFIED BY id-ce-policyConstraint s } 

PolicyConstraintsSyntax ::= SEQUENCE { 

requireExplicitPolicy [0] SkipCerts OPTIONAL, 
inhibitPolicyMapping [1] SkipCerts OPTIONAL } 

SkipCerts ::= INTEGER (O..MAX) 

12.11.2.13 Extended l<ey usage field 

This field is an extensions of the previous field keyUsage. It is used to define more purposes for which the certified public 
key may be used. 

extKeyUsage EXTENSION ::= { 

SYNTAX SEQUENCE SIZE (1..MAX) OF KeyPurposeld 
IDENTIFIED BY id-ce-extKeyUsage } 

KeyPurposeld ::= OBJECT IDENTIFIER 

12.11.2.14 CRL Distribution points 

This field defines how CRL (Certificate revocation list) information can be obtained. 

cRLDistributionPoints EXTENSION ::= { 
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SYNTAX CRLDistPointsSyntax 

IDENTIFIED BY id-ce-cRLDistr ibut ionPoint s } 

CRLDistPointsSyntax ::= SEQUENCE SIZE (1..MAX) OF DistributionPoint 

DistributionPoint ::= SEQUENCE { 

distributionPoint [0] DistributionPointName OPTIONAL, 
reasons [1] ReasonFlags OPTIONAL, 

cRLIssuer [2] GeneralNames OPTIONAL } 

DistributionPointName ::= CHOICE { 

fullName [0] GeneralNames, 

nameRelativeToCRLIssuer [1] RelativeDistinguishedName } 

ReasonFlags ::= BIT STRING { 

unused (0) , 

keyCompromise (1), 

cACompromise (2), 

af f iliationChanged (3), 

superseded (4) , 

cessationOfOperation (5) , 

certif icateHold (6) } 

12.12 Platform minima 

NOTE: At the time of writing, the minima described in this section have not been tested in real operations. 
It is bcHeved possible that these minima may need to be revised upwards in future versions of this 
specification. 

MHP platform hardware is required to support the following minimum sizes to support the MHP security model: 

• A value of 2 for N in 12.9.2.2, "Security of RCMM" on page 183 

• A minimum depth of 5 levels in the certificate chain 

• A minimum of 5 CRLs 

• A minimum of 10 entries per CRL 

• A minimum of 3 root certificates (regardless of the number of underlying root certificate authorities). 

• A minimum of 3 root certificates for testing (see 12.9.3, "Test certificates" on page 186). 
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13 Graphics reference model 
13.1 Introduction 

The MHP provides tools to control the positioning of: video on an output device, interface components such as buttons 
and lists, as well as raw graphical primitives. 

Each screen coimected to an MHP has three planes which are, from back to front, a background plane, a video plane and 
a graphics plane. 



Background planes 

Video planes 

Graphics planes 




Viewer 



Figure 16 : Illustration of the different types of display planes 

The behaviour of the subtitle plane varies between implementations. API facilities are provided to allow applications to 
make the behaviour predictable. See 13.5, "Subtitles" on page 214. 

An application is provided with a contiguous rectangular region of the graphics plane in which it can draw (see 13.3.3, 
"HAVi devices and AWT components" on page 205). An application can place video, interface elements and graphics 
inside its rectangle on the graphic plane. 

An application can also control video outside of the AWT hierarchy on the video plane, and place still images, video 
drips or solid colour in the background plane. 

The MHP specification enables terminals to support multiple applications at any one time, each of which can have a sub 
area of the screen to which it can draw. The specification enables the areas to overlap. However, the minimum required 
support for these features is profile specific. See annex G, "(normative): Minimum Platform Capabilities" on page 355. 

NOTE :The mapping between planes in this reference model and planes in the hardware used in an MHP 
terminal is implementation dependent. In particular, it is certainly allowed to use planes which the 
terminal hardware considers to be "video" as what MHP considers to be "background" for the 
purposes of displaying MPEG stills and video drips in what MHP considers to be the background. 

13.1.1 Interapplication interaction 

If the presentations of different applications overlap, the areas obscured by other applications are clipped. Therefore 
where an application is translucent it will be blended with the video or background image behind it rather than being 
blended with another application. 
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13.2 General Issues 

13.2.1 Coordinate Spaces 



The MHP includes a number of coordinate systems for different purposes and includes the means to transform between 
these as needed: 

• Input video space 

This considers post upsampling MPEG pixels. 

• Device space 

Logical pixels in the various display devices. There may be different device spaces for the various device types (e. 
g. video and graphics). 

• Normalised screen space 

Normahsed coordinates relative to the output (HScreen). 



Normalised 
coordinates here 
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composition 
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coordinates (pixels) 
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Content 



Processing 
Function 



Figure 17 : 

Various different interfaces provide access to different parts of the graphics and video systems using these coordinate 
spaces. 

13.2.1.1 Normalised screen space 

A normalised screen coordinate system supports references to positions and sizes in the video output from an MHP 
device without reference to any form of pixels. 

This coordinate system describes the top left comer of the screen as {0, 0} and the bottom right comer of the screen as 
{ 1 , 1 } . This coordinate system is used in the positioning of graphics and video on the screen through the a number of 
classes in the org. havi . ui package and the JMF control org. dvb .media . VideoPresentationControl. 

The normalized coordinate system is given through the HScreen. 
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13.2.1.2 User space 

The coordinate space for graphics used in java.awt is defined by applications through the creation of an 
HGraphicsDevice. The root container, an instance of the class org . havi . ui . HScene can be placed within the 
normalised coordinate system. The HSceneTemplate class allows applications to express requirements for their top 
level container Instances of this class are used by HSceneFactory to return instances of an HScene. 
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Coordinate Systems 

(x,y) coordinate system of the Desl<top 
[x,y] coordinate system of the root container 
{x,y} coordinate system of the component 

Figure 18 : AWT Coordinate system in a computer environment 

Figure 1 8 shows the AWT coordinate system in a normal computer environment. In an IVIHP device the 
HGraphicsDevice can be thought of being the desktop and the HScene as being the AWT RootContainer. Thus an 
HScene is placed within the coordinate system of the HGraphicsDevice. An HScene itself defines a new 
coordinate system which pixels are aligned to those of the HGraphicsDevice but the origin is translated (see figure 
18). 

The mapping between the user space and the normalised coordinate system is done given the size and location of the 
HGraphicsDevice in the normalised coordinate system and the resolution of the HGraphicsDevice in pixel. 



(0.0, 0.0) 




HScreen 

(normalised coordinate 
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Figure 19 : Conversion between normalised and user coordinate systems 



(x", y") = normalised coordinate system of HScreen 

(x*^, y") = coordinate system of the HGraphicsDevice in pixels 

j^vu ^ "virtual" user coordinate system in pixels relative to the HScreen 
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Assume the HGraphicsDevice has the origin of (Px",Py") with a dimension of (w",h") and has a pixel resolution of 
w" X h" than the point (x",y") in normalised coordinates is given by 

vu vu 

n X n y 

X = y = -^ 



where 



Res^ ReSy 



n vu W T^ vu n 

Res^ = — Res, 



' h" 



is the virtual resolution of the HScreen in (sub)pixel and 



vu vu u vu vu u 

X = p^ +x y = p^ +y 



is the point (x,y) in the virtual coordinate space with 

Px = Px ■ Res^ Py = Pj, • Resy 



vu n r» ^'W I'W W r» ''W 



being the location of the HGraphicsDevice in the virtual coordinate system. 
Given the Point (x",y") the point (x",y") is given by 



and 



X = floor[(x -p^ ) ■ Res^ +0.5] 



/ = floorliy" - Py") ■ ReSy"" + 0.5] 



Given a HGraphicsDevice which is full screen this simplifies to 
Res/"=w" and Res^^^h", x^ = x^ and y^"=y" thus 
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and 

X = X ■ w y = y ■ n 



u n u n n , u 



Within the above calculations precision equivalent to a float shall be used. Conversion to integer shall only be used when 
the result is a point in a pixel oriented co-ordinate space (e.g. user space). 

The resolution of an HGraphicsDevice is specified using the constant HScreenConf igTemplate.PIXEL_ 
RESOLUTION with a Dimension on the setPref erence (int, Ob ject, int) method. 

The constants HSceneTemplate . SCENE_PIXEL_LOCATION and HSceneTemplate . SCENE_PIXEL_ 
DIMENSION allows applications to define the position and size of an HScene in the coordinate system of the 
HGraphicsDevice (in pixels). The constants HSceneTemplate . SCENE_SCREEN_LOCATION and 
HSceneTemplate . SCENE_SCREEN_DIMENSION allows apphcations to define the position and size which the 
HScene should occupy on the screen in normahsed coordinates. 
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The combination of these defines the transformation between graphics pixels and the video output from the MHP device 
concerned. Only a limited set of transformations are required to be supported. 



(0.0,0.0) 
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Figure 20 : Possible configuration of IHAVi Devices 

Figure 20 shows a possible configuration of HAVi Devices. The HBackgroundDevice is configured to be full screen, 
the HVideoDevice to cover the area of (0.0, 0.125) to (1.0, 0.875). 

When positioning video implementations may snap the video position to an adjacent line vertically (for example, to 
accommodate video and display field order) or an adjacent pixel horizontally (for example, to accommodate display 
chroma structure). The direction of "snapping" shall always be to minimise the error relative to the requested coordinate. 

In figure 20 the HGraphicsDevice is configured to cover the area (0.17, 0.125) to (0.82, 0.875) with a pixel 
resolution of 464x432. 

The HScene can be configured by setting the location of its origin and by defining its dimensions. The location of the 
HScene s origin can be specified by setting the preference HSceneTemplate . SCENE_PIXEL_LOCATION with a 
Point of (0,216) or setting the preference HSceneTemplate . SCENE_SCREEN_LOCATION with a 
HScreenPoint of (0.17,0.5). The dimensions can be configured by setting the preference HSceneTemplate . 

SCENE_PIXEL_DIMENSION with a Dimension of (464,144) or setting the preference HSceneTemplate . 
SCENE_SCREEN_DIMENSION with a HScreenDimension of (0.64,0.25). 

In some implementations and/or configurations pixels in the HGraphicsDevice may not correspond to discrete 
physical pixels in the actual display device. For example, this may be the case when the HGraphicsDevice is 
emulated. 

13.2.1.3 Pixel Aspect Ratio 

A pixel orientated coordinate system does not say anything about the pixel aspect ratio. The pixel aspect ratio (ARx^'"'^ / 
ARyP''''=') is defined by the aspect ratio of the display (AR/"'''''>' / AKf'P^"y, 4:3 or 1 6:9), the area that is covered by the 
HGraphicsDevice (w", h") and the pixel resolution of the HGraphicsDevice (w", h"). See figure 21 
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Figure 21 : Calculating the Pixel Aspect Ratio 

Table 62 shows typical resolutions of a full screen HGraphicsDevice and the corresponding pixel aspect ratios for 
different display aspect ratios. The supported resolutions are defined in G, "(normative): Minimum Platform 
Capabilities" on page 355. 



Table 62 : Typical Resolutions and their pixel aspect ratio (informative) 





4:3 Display 


16:9 Display 


Resolution for full screen 
HGraphicsDevice 


Pixel Aspect Ratio 


Pixel Aspect Ratio 


720x576 (note 1) 


1150:1053 


4600:3159 


768x576 


1:1 


48:36 


1024x576 


36:48 


1:1 


NOTE 1 : Based on 702 nominally displayable pixels derived from ITU- 
R BT470 [28] and ITU-R BT601 [29]. This is approximate 
due to the tolerances defined. 



13.2.1.4 Video space 

The coordinate space for video is that defined by the input video signal after any scaling required by the platform (e.g. 
that required by ETR154). Scaling and clipping of video can be achieved using the JMF control org . dvb . media . 
VideoPresentationControl. The JMF control VideoFormatControl allows applications to query the 
various transformations being performed on video as part of its decoding and presentation. 

13.3 Graphics 

13.3.1 Modelling of the MHP display stack composition 

The following sections describes the theoretical model of the MHP display stack. Unfortunately, certain real world 
constraints may apply see section 13.6, "Approximations" on page 215. The "Graphics, Video and Subtitle pipeline" is 
illustrated in figure 22. 
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Figure 22 shows the conceptual model of the "graphical content" pipelines from an applications point of view. There are 
four sources of graphical content: subtitles, background, video and application graphics, and these four sources are 
mapped in a controllable way onto single screen. The figure shows the conceptual processing functions, the content 
stages, and application control points inside the content pipelines. 




/ProcessingN Control by 

V function J application 



Figure 22 : Graphics, Video and Subtitle pipeline 

The figure shows that applications have fiill control over the source of the content that enters the different pipelines. 
Furthermore the application may control clipping, scaling and positioning of the content at different stages in the 
different pipelines. Of course an application can only apply operations that are supported by the underlying system. 

The clipping and positioning of subtitles follows the video. Behaviour of subtitles when video is scaled is platform 
dependent. 

From the application author's point of view the behaviour of the graphics composition process has 3 elements: 

• The graphics elements are composed following the traditional graphics model using Porter-Duff rules (see Porter- 
Duff [D]).The default rule used is the SRC_OVER rule. 

• The background and video planes are composed using the Porter-Duff rule SRC_OVER (Note that only alpha of 
and 1 is used in the Video planes). 

• The results are composed together using the SRC_OVER rule (with the graphics results as the source and the 
results of the background / video composition as the destination). 

This is illustrated in figure 23. 
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Figure 23 : Overview of AWT / HAVi plane composition 
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The HAVi stack has a single full screen HBackgroundDevice at the back. In front of this are an ordered set of zero or 
more HVideoDevices. Each of the video devices can occupy the full screen area or part of it. Any area that is not 
occupied behaves as transparent. The occupied areas (video pixels) are considered to be opaque and will be obscured by 
any video devices in front of them. Non active video devices are invisible. 

Systems that support only a single video device that can display full screen (and possibly other partial screen video 
devices) should report the fiill screen capable device as the first (back most) of the video devices. 

The composition rules in each group follow the traditional "painter's" algorithm i.e. composing the layers from back to 
front. 

The Xlet AWT Root Component is transparent (as shown in figure 24) so by default the result of the HAVi video and 
background device composition is the background to any application graphics. 

Video already running in the HVideoDevice will keep on playing when an application starts. 

The stack is illustrated in figure 24. 



Combine with 
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SCR_OVER or 
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HGraphicsDevice 
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Figure 24 : The MHP display stack illustrated 
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13.3.2 AWT Reference Model in the MHP 

In the AWT all graphics rendering of the lightweight components is done via the Java . awt . Graphics class. When a 
component needs to be redrawn it issues a repaint command which gets passed from component to component from top 
to bottom until a heavyweight component is reached. Although there are no heavyweight components in the MHP the 
HScene can be thought of being similar to a heavyweight component. Thus in MHP devices the repaint command gets 
passed until it reaches the root container - the HScene. The repaint method of the HScene causes a call to this 
component's update method as soon as possible. Before calling the paint method of a child the origin gets translated to 
the coordinate system of the child and the graphics object passed is clipped to the size of the child (see figure25) 



repaint 



paint(Graphics) 




Figure 25 : Repaint model in the IVII-iP 

13.3.3 HAVi devices and AWT components 

The top level user interface container for DVB-J applications is represented by the org . havi . ui . HScene class. 
DVB-J applications may obtain an instance of this class from an instance of org . havi . ui . HSceneFactory. The 
HSceneFactory class provides a number of methods which may be used to obtain an HScene depending on the 
specific requirements of the DVB-J application. HScene is conceptually equivalent to Java . awt . Window or Java . 
awt . Frame however it models the differing graphical environment found in many digital TV receivers. In this 
environment, there are typically significant constraints on what sizes and positions of top level containers may be 
possible. 

One means for obtaining an HScene from an HSceneFactory is to populate an HSceneTemplate with a set of 
constraints and then request an HScene from the getBestScene ( ) method which meets these constraints. 
Apphcations wishing to obtain a full screen sized HScene may use thegetFullScreenScene () method specifying 
a particular graphics device on which the full screen scene should be presented. 
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MHP tenninals are allowed to support only non overlapping HScenes. In implementations not supporting overlapping 
HScenes the following behaviour shall be implemented: 

• Overlapping at creation or size change through HSceneFactory: 

returns a null reference if "REQUIRED" is used. Returns best effort if "PREFERRED" is used. 

• Overlapping later when sizes change by awt: 

Size does not change. Fails silently. 

The MHP specification provides a general model for video output devices using the model found in the HAVi 
specification. A final output video signal is expressed through the org . havi . ui . HScreen class and is the result of 
adding a number of different video components. 

• The output of one or more graphics decoders 

• The output of one or more video decoders 

• The output of any special decoders, e.g. a background 

An abstraction of each of these decoders is represented by an instance of a class inheriting from HScreenDevice - 
HGraphicsDevice, HVideoDevice and HBackgroundDevice respectively. Each of these can potentially exist 
in a range of configurations which are exposed by instances of classes inheriting from HScreenConf iguration - 
HGraphicsConf iguration, HVideoConf iguration and HBackgroundConf iguration respectively. 
Where devices support multiple configurations, applications may construct and populate templates to define criteria to 
select between configurations. These templates are classes inheriting from HScreenConf igTemplate. 

As well as the general features, some of these sub-classes provide support for specific features of the devices concerned. 
HGraphicsConf iguration supports loading of images and listing of fonts specific to that configuration. It also 
support conversion between various coordinate systems. HVideoDevice provides access to the source of the video 
currently being decoded (a Locator) and provides access to the decoder object for the video currently being decoded (a 
javax .media .Player). The HBackgroundClass provides a means to support MPEG I-frames through the 
HStilllmageBackgroundCon figuration class. 

The method HScreen . getCoherentScreenConf igurations ( HScreenConf igTemplate [ ] 
conf igs ) allows applications to express a common set of constraints for video, graphics and backgrounds and get 
back a coherent answer. In HGraphicsConf igTemplate, the constant VIDEO_MIXING allows applications to 
request configurations where graphics is super-imposed above video but without any requirement for pixels to be aligned. 
In HScreenConf igTemplate, there are constants to allow applications to ask for configurations as foUows:- 

• VIDEO_GRAPHICS_P IXEL_ALIGNED - video & graphics pixels are the same size and aligned 

• ZERO_VIDEO_IMPACT - a graphics configuration must not change the existing video configuration 

• ZERO_GRAPHICS_IMPACT - a video configuration must not change the existing graphics configuration 
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13.3.3.1 Video and graphics pixel aligned 

The VIDEO_GRAPHICS_PIXEL_ALIGNED relationship between the pixels in the HGraphicsDevice and the 
pixels in the HVideoDevice is shown in figure 26. Note that the relationship applies to the pixels in HVideoDevice 
after "Decoder Format Conversion" processing, and the pixels in HGraphicsDevice. As a result of this relationship 
the following constraint holds for the configurations of HGraphicsDevice and HVideoDevice that have aligned 
video and graphics pixels: 

• the pixel aspect ratio of the pixels in both devices is equal. 
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Figure 26 : Video and graphics pixel impact 
13.3.3.2 Zero graphics impact 

Constants ZERO_GRAPHICS_IMPACT and ZERO_VIDEO_IMPACT can be used by applications to prevent changes to 
the HGraphicsDevice or the HVideoDevice respectively, in the case that changes are not intended. In general a 
change of the configuration of the HGraphicsDevice may lead to an automatic change of the configuration of, for 
example, the HVideoDevice (if the application is authorised to make this change), because restricted systems may not 
be able to deal with the two different configurations simultaneously. Therefore an application must specify ZERO_ 
GRAPHICS_IMPACT or ZER0_VIDE0_IMPACT in the configuration template if it does not want to change the 
configuration of another device. 

13.3.4 Composition 
13.3.4.1 AWT paint rule 

The normal AWT paint rules shall be followed. That is the root container (the HScene) is painted and then its 
components are painted recursively. 

The observed behaviour shall be such that of each component drawing directly into the root component. Any use of 
temporary storage or double buffering shall not affect the final result of the AWT composition or its subsequent 
composition with the result of the video composition. 
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The process is shown in Figure 27. The numbers in the arrows indicate the chronological order of the painting (note the 
root container is painted first). If a container has multiple components they get painted in the order N, N-1,. . .,0 where N 
indicates the order components are added to the parent container (See Documentation on java . awt . Container in 
JAE 1.1. 8 API [31]). 




Figure 27 : Chronological order of painting 

13.3.5 Composition Rules 
13.3.5.1 Components generally 

By setting an appropriate DVBAlphaComposite rule on a DVBGraphics and using translucent colours blending 
may be achieved. By repeated placement of components complex scenes can be described. In figure 28 the background 
picture (of the harbour) is representative of the video plane. The translucent grey rectangle is drawn into a transparent 
off-screen buffer using the SRC rule. The red circle is then drawn into this off-screen buffer using one of the 8 most 
common Porter-Duff operations. When the AWT rendering in the off-screen buffer is complete it is composited with the 
video using the SRC_OVER rule. 




'M^^'^QVER 



Figure 28 : Summary of the Porter-Duff rules 
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13.3.6 Extensions to the AWT graphics capabilities 

For graphics the MHP specification mainly uses AWT facilities defined in JAE 1.1.8 API [31]. However, certain 
extensions are made. 

In order to allow compositing in the MHP the graphics capabilities of JAE 1.1.8 API [31] have been extended by 
providing the org . dvb . ui package. 

The package consist of the classes DVBGraphics, DVBAlphaComposite, DVBBuf f eredlmage, DVBColor and 
one Exception. See U, "(normative): Extended graphics APIs" on page 687. 

13.3.6.1 Graphics Objects in the MHP 

The class org . dvb . ui . DVBGraphics extends the normal Java . awt . Graphics class by adding support for 
alpha compositing. 

In the MHP each platform-created graphics object shall be an instance of org. dvb.ui. DVBGraphics. 

DVBGraphics and DVBAlphaComposite has a principle support of 8 different Porter-Duff compositing rules but 
not all rules have to be supported for all DVBGraphics Objects. 

Different DVBGraphics Object could support different compositing rules. E.g. a DVBGraphics Object created using 
a DVBBuf f eredlmage with an image type of DVBBufferedImage.TYPE_ADVANCED supports all 8 specified 
Porter-Duff rules, TYPE_BASIC supports only SRC, CLEAR, SRC_OVER. Application can query the available 
compositing rules using DVBGraphics . getAvailableCompositingRules ( ) . When setting an unsupported 
compositing rule a org. dvb.ui .UnsupportedDrawingOperationException will be thrown. All images 
whose getGraphics method returns a non-null object shall support alpha. 

The supported compositing rules are defined in G, "(normative): Minimum Platform Capabilities" on page 355. 

The default compositing rule used by all graphics objects is SRC_OVER. 

13.3.6.2 Buffered Image 

The class DVBBuf f eredlmage in the package org. dvb.ui adds the support for an accessible, transparent Image which 
can be used e.g. for off screen buffers. Two different platform dependent sample models are supported by 
DVBBuf f eredlmage. When doing compositing in the TYPE_BASE sample model approximations may be applied 
(using SRC instead of SRC_OVER, see figure 36 or by approximating the alpha, see G, "(normative): Minimum 
Platform Capabilities" on page 355) while in the TYPE_ADVANCED sample model the compositing rules set by the 
program will be used. 

TYPE_ADVANCED is always a direct colour model while TYPE_BASE can be a CLUT based colour model. 

13.3.6.3 DVBColor 

Note The general philosophy of this class has been to imitate the features of JDK 1.2 dealing with colour. 

Unless explicitly specified otherwise, the internal implementation of the platform (e.g. j ava . awt) shall use the org . 
dvb . ui . DVBColor class instead of the Java . awt . Color where technically possible (e.g. not the constructor for 
Java . awt . Color). The class signatures shall not change. For example, where a method is specified to return Java . 
awt . Color it shall return an instance of org . dvb . ui . DVBColor. 
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13.3.6.3.1 Modified pacl<ed colour representation 

The most significant byte of the integer representation of an RGB colour is defined to hold an alpha value as is illustrated 
in figure 29. This data type is used in various of the constructors and methods described in the API documentation. It is 
referred to in the API documentation as TYPE_INT_ARGB. 
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Figure 29 : MHP colour format (TYPE_INT_ARGB) 

1 3.3.7 1 4:9 Aspect Ratio Support 

As well as the real display aspect ratios of 4:3 and 16:9, MHP defines a 14:9 aspect ratio. When this is in effect, all text 
will be subject to moderate aspect ratio distortion. However, broadcasters will be able to predict text flow without having 
to author specifically for each display type. 

All HGraphicsDe vices must be HEmul at edGraphicsDe vices capable of emulating al4:9 aspect ratio on their 
actual aspect ratio at the time. 

NOTE: Applications can still set the configuration of an HEmulatedGraphicsDevice to an 
HGraphicsConf iguration and have this be supported without emulation. 

Where the current configuration of an HEmulatedGraphicsDevice has a 14:9 aspect ratio and the device is not 
reserved by any MHP application, the MHP terminal shall automatically maintain this 14:9 aspect ratio if the real 
underlying aspect ratio changes between 4:3 and 16:9 or vice-versa. 

NOTE: The HGraphicsConf iguration observed by an application when it starts running may be 
unpredictable since there may be an already rurming MHP application which has reserved the 

HGraphicsDevice and set the HGraphicsConf iguration. 

13.4 Video 

13.4.1 Component-based players and background players 

Video is received by the MHP as an MPEG sequence of compressed frames, each of which contains a large number of 
picture elements (pels) arranged in rows and columns. The MHP decodes the MPEG stream to a presented stream which 
may be placed either in the video plane, or in a component in the graphics plane. 

These two different ways of presenting video result in having two different kinds of JMF players, a background JMF 
player and a component-based JMF player. 

A component-based JMF player plays video inside an AWT component, and the video inside that component is 
positioned and scaled by positioning and resizing the component. The video is always scaled to the full size of the 
component. Support for component-based players is not mandatory in all profiles. 

Support for background players is mandatory for broadcast streaming formats (see 7.2, "Broadcast streaming formats" on 
page 54). 

Background JMF players play video in the video plane, outside and independent of any AWT component hierarchy. 

When a component-based player is stopped, the last displayed frame shall continue to be displayed until the underlying 
video decoder resource is re-used. The behaviour when the underlying video decoder resource is re-used is 
implementation dependent. 

When a background player is in the realized state, the video plane concerned shall become transparent to expose what is 
behind it such as background plane(s). See figure 16, "Illustration of the different types of display planes" on page 197. 
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13.4.2 Modelling MPEG decoding and presentation pipeline 

Figure 30 illustrates the underlying format conversion control process in a ETSI TR 101 154 [9] compliant SD digital 
receiver. In this model the video decoder produces "full-screen" video from the MPEG data (i.e. the decoder resolves any 
sub-sampling in the MPEG broadcast). Subsequent "Decoder Format Conversion" adapts this for the display device 
taking account of: 

• broadcast meta data (aspect ratio, pan/scan and active format description) 

• display knowledge (4:3 or 16:9, and resolution) 

• user preferences (e.g. display wide screen in a letterbox) 
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Figure 30 : Format control in TV mode 

If appropriate, the video that is sent to the display is accompanied by the proper WSS or SCART signalling to indicate 
the format of the video that is being sent. 

Note that the display device may do its own Decoder Format Conversion on top of the Decoder Format Conversion that 
the MHP device does. This is beyond the control of the MHP device. 

The JMF players in this version of the MHP specification are "DVB ETR 154 Standard Definition" players and so act as 
if they are taking the full screen output of the MPEG Video Decoder as their logical input video source, as is illustrated in 
figure 3 1 . In addition, there are two alternative sources of control for the "Decoder Format Conversion" process: 

• Conventional TV format control behaviour (as in figure 30) 

• Application format control behaviour 

The selection between these behaviours is under the control of the application. Before and after the existence of an 
application the behaviour is that for a conventional TV. During application execution the default behaviour of the JMF 
player's decoder format conversion shall be the conventional TV behaviour. 
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Figure 31 : Format control in the presence of a JIVIF player 
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The Decoder Format Conversion consists of three steps that are performed on the full screen input video, which may 
have been up-sampled by the MPEG video decoder to become full screen. As illustrated in Figure 32, these steps are 
clipping, scaling and positioning. 



Decoder Format Conversion 



Clip 
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Figure 32 : Reference model for Decoder Format Conversion 

An application can query the implemented capabilities of each step of the Decoder Format Conversion using the org.dvb. 
media. VideoPresentationControl ("VideoPresentationControl" on page 533). For instance, it can query the supported 
scaling factors. 

An application can also set up the Decoder Format Conversion steps atomically by using an org.dvb.media. 
VideoTransformation object ("VideoTransformation" on page 538) that encapsulates the clipping, scaling, and 
positioning parameters. An application can get a number of pre-defined video transformations that correspond with 
standard Decoder Format Conversions like 16:9 letterboxing in a 4:3 display. It can either use these video 
transformations directly to set the Decoder Format Conversion, or it can change one or more parameters of the 
transformation before setting it. The API also offers support for querying the current video transformation. 

13.4.3 Coordinate Spaces 

The input to the Decoder Format Conversion block is always full screen video. If necessary, the MPEG video decoder 
block performs up-sampling as required by ETSI TR 101 154 [9] to get full screen video. 

An application expresses the video clipping in terms of the pixel-based coordinate space of the full screen video. For 
50Hz SD video this is always a 720x576 raster. 

Positioning of the video is expressed in the normalised coordinate space for background JMF players. For component- 
based JMF players, the position of the video component is expressed in the pixel-based device coordinate space (i.e., a 
video component is positioned like any other AWT component). 
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13.4.4 Video components 

A scaled portion of a video can be presented as a component within the AWT hierarchy. The controls that influence this 
presentation are parts of AWT and JMF. 



Video components are treated just like any other component. However, it shall be noted that pixels within the video have 
opaque colours. The mapping to the source video is provided by the video presentation control (see N, "(normative): 
Streamed Media API Extensions" on page 495) which allows an arbitrary portion of the video to be placed within the 
AWT hierarchy. 
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Figure 33 : Introducing video into the AWT component stack 
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13.5 Subtitles 

13.5.1 Language and presentation setting 

The following reference model shows the how the presentation of subtitles is controlled. The selection of the subtitles 
language depends by default on the user's preferences, the audio language and can be ovenidden by the application. The 
end user can set the subtitles on or off where the default depends on the preferences. The application can override all this 
and switch the subtitles off even if the user has set them on. 

The figure below illustrates the decision procedure: 
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Figure 34 : Determining subtitling language and presentation setting 

The DVB-J API includes a control (see "SubtitlingEventControl" on page 524) that the application can use to get notified 
of the state changes in the availability and presentation status of the subtitles. This corresponds to the status of the left 
hand side input and the right hand side output in the diagram. The language selection and the resulting preferred 
language are determined using an implementation dependent algorithm, e.g. the platform may support separate language 
preferences for audio and for subtitles. 

The org.davic.media.SubtitlingLanguageControl allows the application to query the currently set subtitling language, 
override the default language setting and switch the subtitles off or let them be end user controlled. This corresponds to 
the language selection phase and the application controlled switch in the diagram 

13.5.2 Relation to grapiiics 

Ideally subtitles should be presented on top of the video plane but below the graphics plane(s). However, MHP terminals 
conforming to this specification are only required to support subtitles in areas where they are not overlapped by 
application graphics (i.e. by an HScene for a DVB-J application). The behaviour if the subtitles overlap with application 
graphics is non deterministic. Therefore, when presenting application graphics on screen, the application should either 
turn subtitles off or the broadcaster shall coordinate the use of screen area between subtitling and application graphics so 
that they will not overlap. 

The subtitling plane is full screen and allows the subtitles to be positioned anywhere on screen. The positioning of the 
subtitling texts is part of the subtitling stream content and is fully controlled by the broadcaster. 

13.5.3 Coordinate Spaces 

Subtitles are decoded into a plane with the same coordinate system and position as the HVideoDevice. 
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13.6 Approximations 

13.6.1 Approximations in composition 

The MHP specification references tlie Porter-Duff rules for composition (see Porter-Duff [D]).The minimum set of 
operations required is defined in (G. 1.3.1, "Composition rules" on page 356), in addition the implementation of the 
compositions may be approximated as detailed below. 

13.6.1.1 Implementation of modes 

Typical implementations have a hardware blending process that blends the graphics plane over the video using SRC_ 
OVER (see figure 35). This places certain practical limitations on the purity of the display model. 



Graphics Alpha 




Graphics Chroma 



I Composed Video etc. 
Figure 35 : Typical current technology implementation 

The SRC rule simply requires that the colour and alpha characteristics of the new pixels replace those previously present. 

HVideoComponent s are treated as having an alpha of 1 so whether SRC or SRC_OVER is used when placing the 
video component the effect is that the video completely replaces anything previously drawn. 

For the purposes of this discussion, MPEG I-frames and video drips shall be considered as video and not as graphics even 
if particular implementations may implement them using part of the graphics system of their hardware. 

13.6.1.1.1 Graphics directly over video 

When drawing graphics directly over video: 

• The effect of SRC_OVER mode is as expected as the alpha value of the drawn graphics is used to control blending 
of the graphics with the video. 

1 3.6. 1 . 1 .2 Graphics over other graphics 

13.6.1.1.2.1 SRC 

If graphics are painted over other graphics using SRC mode the result is as expected. 

13.6.1.1.2.2 SRC_OVER 

If graphics are painted over other graphics using SRC_OVER mode the result will be implementation dependant when 
< alpha < 1. Drawing with colour where alpha = (i.e. fully transparent) shall not cause any effect to the existing pixels. 
Figure 36 on page 216 illustrates a variety of implementations of SRC_OVER graphics to graphics blending. One 
allowed behaviour where the sample model is of TYPE_BASE is that defined in JAE 1.1.8 API [31] for those signatures 
of the drawlmage methods in Java . awt . Graphics which do not have a "bgcolor" parameter. Specifically, 
only pixels which are fully opaque are drawn at all. Pixels which are transparent to any extent do not affect whatever 
pixels are already there. 

[a] Shows the logically correct result where the green and red areas mix to produce intermediate 

colours. 

This implies a graphics to graphics blending process, it also implies a large gamut in both the chroma and alpha channels. 
This may not be practical in many early implementations. 

The following cases illustrate simplifications of the blending scheme. These should not be considered equally good 
approximations: 
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[b] Here the graphics alpha is preserved only when it is drawn directly over a video component. When 
drawn over another graphic the alpha facets of the colours are considered to be 1. 

[c] Here the source graphics alpha is preserved when it is drawn over a video component even if there 
is an intermediate semi-transparent graphic. Where the source is over opaque graphics then a 
graphic to graphic blend is implemented. 

[d] Here the source graphics alpha becomes the hardware mixing alpha regardless of what has been 
drawn previously over the MPEG image. 

[e] Here the source graphics alpha becomes the hardware mixing alpha in areas where the alpha is 
already less than 1 . Where the alpha is currently 1 (i.e. over opaque graphics) the alpha remains 1 . 
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Figure 36 : Implementations of blending 



13.6.1.1.2.3 



CLEAR 



If graphics are painted over other graphics using the CLEAR mode the result is as expected. This operation is the same as 
using a source with alpha=0 and the SRC rule. 
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13.6.1.2 Approximation of alpha 

The precision of implementation of alpha depends on the DVBGraphics object concerned. The minimum requirements 
are specified in G, "(normative): Minimum Platfonn Capabilities" on page 355. The actual colour used for a given colour 
can be queried using org . dvb . ui . DVBGraphics . getBestColorMatch ( ) . 

13.6.1.3 Approximation of colour 

Logically the colour model is a "true colour" one. However, colour approximation is allowed as described in G. 1 .5, 
"Colour capabilities" on page 357. 
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14 System integration aspects 
14.1 Namespace mapping (DVB Locator) 

An extended format of the DAVIC DVB URL (DAVIC 1.4.1p9 [3]) shall be used for addressing DVB-SI entities as well 
as files within object carousels. This extension of the DAVIC locator is backwards compatible with both the original 
DAVIC locator as well as the UK DTG extension (UK MHEG Profile [B]). The main extensions are support for multiple 
component tags for specifying a subset of the components of a service, and a specified way of referencing files in an 
object carousel within a service. 

Using the same informal notation as used above, the following locator formats shall be used: 

dvb://<original_network_id>.[<transport_stream_id>][.<service_id>[.<component_tag>{&<component_ 
tag> } ] [ ;<event_id>] ] {/<path_segments> } 

or 

dvb:// ' <textual_service_identifier> ■ [.<component_tag>{&<component_tag>}][;<event_id>]] {/<path_ 
segments>} 

A more formal specification of the DVB URL expressed in BNF (as used in IETF RFC 2396 [41]) is presented below: 

Table 63 : DVB URL syntax 



dvb_url = dvb_scheme " : " dvb_hier_part 

dvb_scheme = "dvb" 

dvb_hier_part = dvb_net_path | dvb_abs_path 

dvb_net_path = "//" dvb_entity [ dvb_abs_path ] 

dvb_entity = dvb_transport_stream | dvb_service | dvb_service_component 

dvb_transport_stream = original_network_id " . " transport_stream_id 

dvb_service = dvb_service_without_event [ dvb_event_constraint ] 

dvb_service_component = dvb_service_without_event " . " component_tag_set [ dvb_event_ 
constraint ] 

dvb_service_without_event - original_network_id " . " [ transport_stream_id ] " . " service_id | 

" ' " textual_service_identif ier " ' " 



component_tag_set 




= 


component_tag * ( 


'&" component_tag 


dvb_event_constraint 


= 


" ; " event_id 




original_network_ 


id 


= 


hex_string 




transport_stream_ 


id 


= 


hex_string 




service_id 




= 


hex_string 




component_tag 




= 


hex_string 




event_id 




= 


hex_string 




hex_string 




= 


l*hex 




hex 




= 


digit 1 "A" | "B" 
"d" 1 "e" 1 "f" 


1 "C" 1 "D" 1 "E" 


digit 




= 


"0" 1 "1" 1 "2" 1 


"3" 1 "4" 1 "5" 1 


dvb_abs_path 




= 


"/" path_segments 





I "a" I "b" I 
"7" I "8" I "' 



(path_segments as defined in IETF RFC 2396 [41]) 



It should be noted that this syntax is fully compliant with the generic syntax of URIs as specified in IETF RFC 2396 [41] 

and uses the registry -based naming authority version of that. Furthermore, all generic definitions specified in 

IETF RFC 2396 [41] shall be valid for the DVB URL as well (e.g. escaping of special characters within file names, etc.). 

IETF RFC 2396 [41] defines methods for path segments to include parameters (introduce with a semicolon character 
";")• This specification currently makes no use of such parameters. Implementations conforming to this specification 
shall ignore any such parameters to ensure compatibility with future specifications. 

14.1.1 dvb_entity = dvb_service 

When a path is present in a URL where the dvb_entity part identifies a DVB service, the path references an object in an 
object carousel within the service. If the dvb_service_component element is not present there shall only be one Object 
Carousel in the DVB service. 
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The numeric identifiers original_network_id, transport_stream_id (if present) and service_id shall be matched against the 
corresponding fields in the SDT. 

14.1 .2 dvb_entity = dvb_service_component 

When a path is present in a URL where the dvb_entity part identifies one component of a DVB service and that 
component carries an object carousel stream, the path references an object in an object carousel whose "root" (i.e. DSI 
message) is sent within that component. In this case the component tag set shall only contain one element. 

The semantics when the path is present in URL where the dvb_entity part identifies something else than the two cases 
described above are not specified in this specification. 

The numeric identifiers original_network_id, transport_stream_id (if present) and service_id shall be matched against the 
corresponding fields in the SDT. 

14.1.3 dvb_hier_part = dvb_abs_path 

When the dvb_net_path part is missing and only the dvb_abs_path is present, the URL refers to a file in a default object 
carousel within the current service. The "current" service is dependent on the usage context. 

14.1.4 dvb_abs_path 

The following restrictions apply to the dvb_abs_path part of a name: 

• The total length of pathnames, separators and filename shall be less than or equal to 254 bytes long. 

• The following characters are not allowed in filenames and pathnames: character null (OxCOSO), byte zero. 

• The encoding of the filename is in UTF-8 (see 7. 1 .5 on page 54). 

• The directory separator character (i.e. Java's path. separator property) shall be a slash character (0x2F). 

• An absolute filename starts with a slash character (as indicated in the BNF above). 

14.1 .5 dvb_entity = dvb_transport_stream 

The numeric identifiers original_network_id and transport_stream_id shall be matched against the corresponding fields 
in the NIT. 

14.2 Reserved names 

File names starting with the characters "dvb." are reserved for use as "well known" files defined in this or future 
specifications. 

Authors shall not use file names with this form to avoid possible collision with standards defined files. 
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14.3 XML notation 

These rules shall apply to the processing and encoding of all the files where XML is used as an encoding format in the 
MHP. 

Rules for encoding of the XML formatted files: 

• the file shall be a well-formed XML document (but not necessarily valid against the DTD specified in this version 
of this specification). Here 'well-formed' and 'valid' are used as defined in the XML 1.0 (see XML 1.0 [65]) 
specification. 

NOTE: The remark on validity is included, because it is possible to be valid only relative to one DTD. Valid 
documents relative to a DTD specified in a later version of this specification would not be valid 
relative to the DTD specified in this specification - however, the rules defined here intend to provide 
this future-proofness and allow terminal implementations compliant with this specification to be 
able to process files that may be encoded according to a later version of this specification. 

• the XML files may contain the XMLDecl item ("<?xml . . . ?>" tag) in the prologue in the beginning of the file 

• all the XML files shall be formatted using the UTF-8 character encoding which is the default used in XML 

• the possible XMLDecl item in the beginning of the file shall not contain an 'encoding' attribute specifying another 
encoding than UTF-8 

• if the XMLDecl item is included in files conforming to this specification, it shall indicate XML version 1.0 

• the XML file shall contain a document type declaration ("<!DOCTYPE . . .>" tag) where the Name is the same as 
the name of the root element 

• the document type declaration shall contain an External ID item with the "PUBLIC" identifier and both a 
PublicLiteral and a SystemLiteral. This specification specifies the PublicLiteral that shall be 
used to identify the document types defined in this specification. This specification specifies aSystemLiteral 
that can be used for identifying a location where the DTD can be retrieved. The SystemLiteral included in 
the document type declaration shall point to a location where the DTD can be obtained via the Internet using the 
HTTP protocol as specified in this specification. 

• the PublicLiteral is used for identifying the type of the file. For document types specified in this 
specification, the PublicLiteral shall have the following syntax: 

"-//DVB//DTD " <document type> " " <version_number> "//EN" 

where: 

<document type> has the following syntax: 

<document_type> = letter letters 
letters = "" I letter letters 

letter = uppercase_letter | lowercase_letter | space 
upper case_letter = "A" | "B" | "C" I "D" | "E" | "F 

I "I" I "J" I "K" I "L" I "M" 

I „p„ I „Q„ I „R„ I „g„ I „-[.„ 

I "W" I "X" I "Y" I "Z" 
lowercase_letter = "a" I "b" I "c" I "d" I "e" I "f" 

I "i" I "j" I "k" I "1" I "m" I 

I "p" I "q" I "r" I "s" I "t 

I "w" I "x" I "y" I "z" 
space = " " 

<version_number> has the following syntax: 

<version_number> = ma jor_version " . " minor_version 

ma jor_version = digit digits 

minor_version = digit digits 

digit = "0" I "1" I "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" 

digits = "" I digit digits 
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1 "G" 


1 "H 


1 "N" 1 


"0" 


1 "U" 1 


"V" 


"g" 


"h" 


1 "n" 1 


"o" 


1 "u" 1 


"v" 
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The <document_type> part of the PublicLiteral is used as an identifier of the document type. When 
future versions of this specification specify newer, backwards compatible versions of the document type, the 
<document_type> part shall not be changed and the <version_number> part shall be changed to a new 
version number unused in a previous version of this specification for that document type. 

• the XML file shall be valid relative to the DTD identified in the Externalld document type declaration. 
Here 'valid' is used as defined in the XML 1.0 specification. 

• the document type declaration shall not contain a declaration part in square brackets ('[' and ']') 

• where the XML type PCDATA is used in XML elements and it is specified that this contains a string (for example 
a file name), these strings shall not contain '<', '&' or '>' characters that might be mistaken as XML tags or 
references of the markup. 

NOTE: Strings where these characters must be allowed should be specified to be encoded as CDATA, 
leading to a more complex notation but allowing those symbols to be used. 

• the file shall include only tags and attributes that are defined in this specification or a later version of this 
specification 

• the file shall not include XML entity declarations ("<!ENTITY . . ..>" tags) 

• the file shall not include XML character or entity references (references starting with '&' character) 

• the file shall not include XML processing instructions, except optionally the "<?xml . . .?>" XMLDecl item 

• the file may include XML comments ("<!— . . . — >" strings), but not within elements that are specified as PCDATA 
containing strings to be encoded as defined in this specification 

Rules for processing of the XML formatted files in the MHP terminal: 

• theparser shall use the PublicLiteral in the document type declaration in the XML file ("<!DOCTYPE ...>" 
tag) for identifying the type of the file. 

• The PublicLiteral in the document type declaration identifies the version of the DTD that is used for this 
file. There is no requirement for the parser to try to fetch that DTD file using the URL defined by the 

Sy stemLiteral. It is an implementation option for the parser to retrieve the DTD from that URL. If the DTD 
is unavailable from that URL, then the behaviour shall be platform dependent. 

• The parser shall accept files that have a different version number in the PublicLiteral than the one specified 
in this specification for the given file type. These are probably files encoded according to a different version of this 
specification. From those files, the parser shall parse, recognize and handle all those elements and attributes that 
are part of the DTD included in this specification. 

• the parser shall ignore all XML elements (start tag, end tag, and possible string between them) that are not 
specified in the DTD included in this specification. 
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NOTE: This allows extending the DTDs in the future in a future proof manner where existing terminals 
ignore all the elements introduced in later versions of this specification 

• the parser shall ignore such attributes of XML tags that are not specified in the DTD included in this specification 

• the parser shall ignore XML comments encoded as defined in the XML 1 .0 specification 

• the parser must accept empty XML elements specified in this specification both in their start-tag and end-tag form 
as well as in the empty element tag form (e.g. '<tuning value="true"></tuning>' may be used as well as '<tuning 
value="true"/>') 

• rules for evolving the specification must ensure that the encoding of the file will always be maintained backwards 
compatible when these rules are followed (i.e. later versions of this specification may add new XML tags and new 
attributes to existing XML tags, but may not change the semantics of the existing elements) 

• if the encoding of the file violates the rules defined for the encoding above, the behaviour of the parser can be 
platform dependent, including the possibility that the parser may completely discard such files and the system 
may behave as if the file is not present at all. 



14.4 Network signalling 



The behaviour of MHP terminals when receiving incorrectly formatted data, however transmitted or otherwise acquired, 
is implementation dependent except where a specific error behaviour is required by this specification or referenced 
specifications. MHP terminals may implement whatever strategy they like for this situation. It is an allowed 
implementation choice to pass values from the network straight through to applications without checking them for 
correctness. Hence API calls which are specified as returning a specific piece of information may not return a valid piece 
of information if the original information in the network is wrong. 

MHP terminals should observe the behaviour defined in section 4.1 of ETSI TR 101 154 [9]. 

NOTE: It is highly recommended that the MHP terminal should be designed to allow for future compatible 
extensions to the DVB SI, DSMCC or other formatted data interpreted by the MHP terminal. All of 
the fields "reserved" (for ISO), "reserved_future_use" (for ETSI), and "user defined" in 
thcETSI EN 300 468 [4] should be ignored by MHP terminals not designed to make use of them. 
The "reserved" and "reserved_future_use" fields may be specified in the future by the respective 
bodies, whereas the "user defined" fields will not be standardized. Where an MHP API provides 
access to this data, the data should be returned to the MHP application without validation or 
correction. 

14.5 Text encoding of application identifiers 

Where an organisation_id or application_id is encoded in textual form it shall be encoded as follows: 

• a hexadecimal representation of the value 

• lower case letters 

• no extra leading zeros (as would be produced by Integer.toHexString) 

Where both an organisation_id and application_id are combined into an application identifier, they will be represented as 
a single hexadecimal number using the previously described encoding with the organisation_id as the most significant 
bits and the application_id as the least significant bits. 
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14.6 Filename requirements 

14.6.1 Persistent storage 

Receivers shall support path and file names as specified by persistentpath and persistentf ilename in the 
following BNF: 

lowalpha = "a" I "b" I "c" I "d" I "e" I "f" I "g" I "h" | "i" | 
"j" I "k" I "1" I "m" I "n" I "o" I "p" I "q" I "r" | 
" s " I " t " I " u " I " V " I " w " I " X " I " y " I " z " 

upalpha = "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | 
"J" I "K" I "L" I "M" I "N" I "0" I "P" I "Q" I "R" I 
"S" I "T" I "U" I "V" 1 "W" 1 "X" 1 "Y" 1 "Z" 

alpha = lowalpha I upalpha 

digit = "0" I "1" I "2" | "3" | "4" | "5" I "6" I "7" 
" 8 " I "9 " 

punct = "_" 

persistentf ilechar := alpha I digit I punct 

persistentf ilesubstring := persistentf ilechar | persistentf ilesubstring persistentf ilechar 

persistentf ilename = persistentf ilesubstring 

I persistentf ilesubstring " . " 

I persistentf ilesubstring " . " persistentf ilesuf fix 
persistentpath = persistentf ilesubstring | persistentpath "/" persistentf ilesubstring 

persistentf ilesuf fix = persistentf ilechar | persistentf ilesuf fix persistentf ilechar 

Receivers are required to support: 

• persistentf ilesubstrings of length less than or equal to 8 characters 

• persistentf ilesuf fixes of length less than or equal to 3 characters 

Receivers are not required to reject filenames which exceed these requirements but applications using such filenames are 
not compliant. 

Receivers shall have filesystems for persistent storage which are either case sensitive or "case preserving". Applications 
shall be written to work on both of these, "case preserving" filesystems are case insensitive when opening an existing file 
but preserve the case which was used when the file was initially created. 

14.6.2 DSMCC object carousel 

Receivers shall support object carousels at least matching these requirements; 

• file paths (i.e. the concatenation of directory names, directory separators and a filename) must be <= 1024 bytes 
long 

• within the file path requirement, file and directory names must be <= 255 bytes 

• the OC file system shall be case sensitive 

Other object carousel limitations are found in B.2.8, "Mapping of objects to data carousel modules" on page 319. 

NOTE 1 : There is no limit on the maximum number of directory nesting levels as long as the limit on file 
paths is not exceeded. 

NOTE 2: Authors should avoid relying on OC being case sensitive since some authoring platforms will get it 
wrong. 
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NOTE 3 : To ease development of applications on computer platforms using traditional file systems the author 
is recommended to restrict file names to the character codes 0x21 to 0x7E excluding 0x22, 0x27, 
0x3A, 0x3B, Ox5C (double quote, single quote, colon, semicolon, backslash). 

14.7 Files and file names 

The MHP specification defines how applications can use the names of files in order to access content held in files. It is 
intentionally silent about the file systems and file system namespaces of MHP terminals except as defined below. 

• When an MHP application starts, the filesystem where that application is carried will be mounted into the file 
system namespace of the MHP terminal concerned. For a DVB-J application 11.5.1, "Broadcast Transport 
Protocol Access API" on page 123 defines that creating a new instance of j ava . io . File { " . " ) will result in 
a reference to the base directory of the application. This base directory may be a sub-directory within this 
filesystem. 

• MHP applications which have requested the right to access persistent storage, and had this right granted, are 
allowed to access the persistent file namespace. For DVB-J applications, the top level directory of this namespace 
is obtainable from the system property, "dvb .persistent, root". 

• MHP applications may have the ability to mount additional filesystems into the file system namespace of the 
MHP terminal concerned. DVB-J applications are allowed to use the attach ( ) method on the org . dvb . 
dsmcc . ServiceDomain class in order to attach an object carousel as an additional file system. In all other 
methods, using a DVB locator including the dvb_abs_path part of the name part of the syntax shall not mount 
the specified object carousel file system. 

• Conformant MHP applications shall not attempt to access files or file systems outside what is allowed by this 
specification. The consequences should they attempt to do this are undefined and implementation dependent. 
Platforms are allowed to choose to limit the access rights of DVB-J applications through use of platform security 
mechanisms, e.g. Java . io . FilePermission. 

• References to content carried in files shall either be done using names of files encoded in text or using "file:" 
URLs as defined in IETF RFC 1738 [67]. File names encoded in "dvb:" URLs shall be transformed to "file:" 
URLs before use. For DVB-J applications, file names shall be encoded in Java String objects and "file:" URLs 
shall be encoded in instances of Java . net . URL. See ServiceDomain . getURL (Locator) . 

When constructing a j ava . net . URL for the "file: " protocol, the host part shall be empty and the path part shall 
be as specified for the constructors of Java. io. File with the platform path separator replaced by "/" and 
omitting the first separator character. 

14.8 Locators and content referencing 

The table below lists the types of entity which this specification requires locators to be able to address. It defines the text 
representation for each entity. Where no text representation is standardised, an implementation dependent representation 
shall be used. This specification does not require support for addressing any other type of entity in an MHP system by 
locator or URL. 

Table 64 : Addressable entities, locators and their text representation (Sheet 1 of 2) 



Entity 


Text Representation 


Transport stream 


DVB locator including "dvb_transport_stream" element. 


Network 


No standardised text representation 


Bouquet 


No standardised text representation 


DVB Service 


DVB locator including "dvb_service" element (note 3). 


Generic Service 


No standardised text representation unless also a DVB 
service 


DVB Event 


DVB locator including "dvb_service" element and "dvb_ 
event_constraint" element 
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Table 64 : Addressable entities, locators and their text representation (Sheet 2 of 2) 



Entity 


Text Representation 


MPEG Elementary Stream 


If the elementary stream is signalled with a component tag 
then this shall be a DVB locator including the "dvb_service_ 
component" element otherwise there is no standardised text 
representation. 


File 


"file:" URL as defined in IETF RFC 1738 [67] (note 1) 
DVB locator including "dvb_abs_path" element (note 2) 


Directory 


"file:" URL as defined in IETF RFC 1738 [67] (note 1) 
DVB locator including "dvb_abs_path" element (note 2) 


Drip feed decoder 


"dripfeed://" 


NOTE 1 : The hostname part of a "file:" URL shall always be the empty string. These URLs 
are always in the namespace of the receiver. Transmitting them across a network 
as part of an application is meaningless. 

NOTE 2: DVB locators including the "dvb_abs_path" element may be returned by MHP APIs 
as a mechanism to provide references to files in carousels which may not currently 
be mounted. These locators can only be used to mount new carousels or be 
translated into a "file:" URL once a new carousel has been mounted. 

NOTE 3: It is not recommended to include the transport_stream_id in references to DVB 
services because the pair (original_network_id, service_id) already uniquely 
identifies the service. 



The DVB specifications define two places where multiple logical service components can be carried in a single MPEG 
elementary stream - DVB subtitles and MPEG-2 multichannel audio. This specification does not provide locators to 
distinguish between multiple languages of subtitles or audio carried in a single MPEG elementary stream in this way. 
Hence methods returning locators for service components / elementary streams shall return the same locator regardless of 
any selection between such logical service components. Methods accepting locators for service components / elementary 
streams shall select between any such logical service components based on the rules for elementary stream selection in 
section 11.4.2.2, "Clarifications" on page 116. 

Where there is no standardised text representation, the implementation specific representation can be used to construct 
Locators which address the original addressable entity but only within that single application instance. 

NOTE: This means there is no requirement to be able to re-use implementation specific representations 
after reading them in from persistent storage or over the inter-application communication API. 

14.9 Service identification 

In the MHP, there are two mechanisms for uniquely identifying a service: 

• the triplet of numeric SI identifiers: 

original_network_id, transport_stream_id and service_id (corresponding to identifiers with 
the same name defined by ETSI EN 300 468 [4] carried in the SI of the broadcast) 

NOTE: It is not recommended to use the transport_stream_id because the tuple original_ 
network_id, service_id already uniquely identifies a service. 

• a textual service identifier: 

textual_service_identifier_bytes carried in the optional Service identifier descriptor in the SDT (see 10.12.1 on 
page 103). 

Both enable global, unique identification of a service. 
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The textual identifier has additional properties: 

• They can identify two (or more) service instances as being the same service even if they for technical reasons have 
different numeric identifiers. 

It is up to the service provider to decide whether different service instances are identified as being the same 
service. 

• They can give alternative identifications for a single service. 

14.9.1 Syntax of the textual service identifier 

The syntax of the textual service identifier is: 

<service_name> " . " <service_provider_domain_name> 

where: 

<service_name>: is a unique name for the service within the service provider's domain 

<service_provider_domain_name>: is an Internet DNS domain name that the service provider has rights to 
control. The organization's administrating the Internet DNS domain names are used as a globally unique registration 
mechanism that allows these textual service identifiers to be globally unique names. 

The <service_name> field shall follow the rules defined for Internet DNS names so that the whole textual service 
identifier is a valid host name to be used in the Internet DNS as defined in IETF RFC 1035 [75]. 

An example of a textual service identifier is: 

movie-channel-l .broadcaster-b . com 

where "broadcaster_b . com" is an Internet DNS domain owned by the broadcaster and "movie_channel_l " 
is a unique name for the service assigned by the service provider 

NOTE: The textual service identifier has the same syntax as an Internet host name and it must be assigned 
in a domain that the service provider has the rights to control. However, the textual service name for 
a service is not required to resolve to any IP address using the Internet DNS service and if it does, 
this version of this specification does not specify any specific services that this host should provide 
if contacted using the IP protocols. 

14.9.2 Handling of the textual service identifiers within the MHP terminal 

The MHP terminal discovers the textual service identifiers for a given service from the SDT table similarly as it discovers 
the existence of the service in the first place. The MHP terminal shall know the textual service identifiers for the available 
services in the same way that it knows the numeric identifiers: original_network_id, transport_stream_id 

and service_id. 

When the application uses a URI referring to a DVB service, the resolution of this URI to the necessary information 
needed to locate the service happens in the same way regardless of if this URI contains a textual identifier or the numeric 
identifiers. 

The URI string provided by the application shall be considered to match the one included in the SDT when the strings are 
the same. 
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14.10 CA system 



In this clause the temi "CA system" appHes to the CA system however implemented and thus embraces both embedded 
CA systems and those implemented via the DVB common Interface. 

If a functioning CA system is exposed to MHP applications at all then it shall be equally exposed through all CA related 
API features, e.g. 

• the CA API 

• CA related reason codes of org. dvb .media .PresentationChangedEvent 

• javax . tv . service . selection .PresentationChangedEvent and sub-classes 

14.10.1 Service selection 

Where the CA system causes changes in the currently decoded service the effect is equivalent to a service selection. 

In the specific case of the DVB Common Interface this will occur when a Host Control tune request is made by a module. 

A javax . tv. service .selection . AlternateContentEvent shall be sent in this case. 

14.10.2 Media component selection 

Requests from the CA system to change in composition of the media components (Audio, Video or subtitles) shall be 
automatically performed (this effect is equivalent effect to using javax.tv.media.MediaSelectControl) and shall be 
reported to the application by the org. davic . net . ca . PIDChangeEvent and org. dvb .media . 
PresentationChangedEvent with reason code either CA_FAILURE or CA_RETURNED as specified for that 
event. It shall also be reported by sending MediaSelectEvents to all currently registered 
MediaSelectListeners whose current selection would be changed by this. 

In the specific case of the DVB Common Interface this will occur when a Host Control replace / clear_replace request is 
made by a module. Events javax. tv. service .selection . AlternativeContentEvent and 
NormalContentEvent shall be sent respectively. 

14.10.3 Non-media component selection 

Requests from the CA system to change in composition of the non-media components (e.g. DSM-CC Object Carousel 
and private data) shall not be automatically performed but shall be reported to the application by the org . davic . 
net . ca . PIDChangeEvent. 

In the specific case of the DVB Common Interface this will occur when a Host Control replace / clear_replace request is 
made by a module. 
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15 Detailed platform profile definitions 

This chapter defines the capabiUties of platforms as presented to appHcations. Products that claim to conform to a profile 
shall provide at least the minimum capabilities identified for the profile. In some cases this implies that specific hardware 
resources are present in the platform. 

Table 65 : Detailed platform profile definitions (Sheet 1 of 2) 



Area 


Specification 


Enhanced 

Broadcast 

Profile 1 


Interactive 

Broadcast 

Profile 1 


Static formats 


Bitmap pictures 


7.1.1.3, "PNG" on page 52 + 15.1, "PNG - restrictions" on page 230 


M 


M 


7.1.1.3, "PNG" on page 52 without restrictions 


- 


- 


7.1.1.4, "GIF" on page 52 


- 


- 


7.1.2, "MPEG-2 l-Frames" on page 52 


M 


M 


7.1.1.2, "JPEG" on page 52 + 15.3, "JPEG - restrictions" on page 230 


M 


- 


7.1.1.2, "JPEG" on page 52 without restrictions 


- 


M 


Audio clips 


7.1 .4, "Monomedia format for audio clips" on page 54 


M 


M 


Video drips 


7.1 .3, "MPEG-2 Video "drips"" on page 52 


M 


M 


Text encoding 


7.1 .5, "Monomedia format for text" on page 54 


M 


M 


Broadcast streaming formats 


Video 


7.2.2, "Video" on page 54 


M 


M 


Audio 


7.2.1 , "Audio" on page 54 


M 


M 


Subtitles 


7.2.3, "Subtitles" on page 54 


M 


M 


Fonts 


Built in 


Character set see annex E, "(normative): Character set" on page 349, 
Metrics see annex D, "(normative): Text presentation" on page 330 
Face: UK RNIB Tiresias' 


M 


M 


Downloadable 


7.4, "Downloadable Fonts" on page 55 


M 


M 


Broadcast channel protocols 




6.2.2, "MPEG-2 Sections" on page 48 


M 


M 




6.2.5, "DSM-CC User-to-User Object Carousel" on page 48 


M 


M 




IP Multicast stack based on: 

6.2.6, "DVB Multiprotocol Encapsulation" on page 49, 

6.2.7, "Internet Protocol (IP)" on page 49 

6.2.8, "User Datagram Protocol (UDP)" on page 49 
6.2.10, "IP signalling" on page 50 





Ro 


Interaction channel protocols 


TCP/IP 


6.3.3, "Transmission Control Protocol (TCP)" on page 50 
6.3.2, "Internet Protocol (IP)" on page 50 


- 


M 


UDP/IP 


6.3.2, "Internet Protocol (IP)" on page 50 

6.3.9, "User Datagram Protocol (UDP)" on page 51 


- 


M 


DSM-CC U-U 
RPC 


6.3.4, "UNO-RPC" on page 50 

6.3.5, "UNO-CDR" on page 51 

6.3.6, "DCM-CC User to User" on page 51 


- 





HTTP 


6.3.7.1, "HTTP 1.1" on page 51 


- 





DNS 


6.3.10, "DNS" on page 51 


- 


M 
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Table 65 : Detailed platform profile definitions (Sheet 2 of 2) 



Area 


Specification 


Enhanced 

Broadcast 

Profile 1 


Interactive 

Broadcast 

Profile 1 


DVB-J 


Core 


11.3, "Fundamental DVB-J APIs" on page 107 


M 


M 


Presentation 


11.4.1, "Graphical User Interface API" on page 112 


M 
(note 1) 


M 
(note 1) 


1 1 .4.2, "Streamed Media API" on page 1 1 6 


M 


M 


Data Access 


11.5.1, "Broadcast Transport Protocol Access API" on page 123 


M 


M 


1 1 .5.2, "Support for Multicast IP over the Broadcast Channel" on 
page 124 





Ro 


11.5.3, "Support for IP over the Return Channel" on page 125 


- 


M 


11.5.4, "MPEG-2 Section Filter API" on page 125 


M 


M 


11.5.5, "Mid-Level Communications API" on page 125 


- 


M 


11.5.6, "Persistent Storage API" on page 126 


M 


M 


Service 

Information & 

Selection 


11.6.1, "DVB Service Information API" on page 127 


M 


M 


11.6.2, "Service Selection API" on page 128 


M 


M 


11.6.3, "Tuning API" on page 129 


M 


M 


11.6.4, "Conditional Access API" on page 130 


M 


M 


11.6.5, "Protocol Independent SI API" on page 130 


M 


M 


Common 
Infrastructure 


11.7.1, "APIs to support DVB-J application lifecycle" on page 131 


M 


M 


1 1 .7.2, "Application discovery and launching APIs" on page 1 32 


M 


M 


1 1 .7.3, "Inter-Application communication API" on page 1 33 


M 


M 


11.7.4, "Basic MPEG Concepts" on page 136 


M 


M 


11.7.5, "Resource Notification" on page 136 


M 


M 


11.7.6, "Content Referencing" on page 136 


M 


M 


11.7.7, "Common Error Reporting" on page 137 


M 


M 


Security 


11.8.1, "Basic Security" on page 1 38 


M 


M 


1 1 .8.2, "APIs for return channel security" on page 139 


- 


M 


11.8.3, "Additional permissions classes" on page 140 


M 


M 


Others 


11.9.1, "Timer Support" on page 140 


M 


M 


11.9.2, "User Settings and Preferences API" on page 140 


M 


M 


11.9.3, "Profile and version properties" on page 140 


M 


M 


NOTE 1 : The javax.tv.graphics.TVContainer.getRootContainer method shall return an instance of org. 
havi.ui.HScene or null. 



Key 


- 


Not required / Not applicable 





Optional feature in the receiver 


Ro 


Recommended optional feature in the receiver 


M 


Mandatory feature in the receiver 
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15.1 PNG - restrictions 

MHP terminals are required to support ALL of the PNG colour types defines in PNG Specification Version 1 .0 (see table 
66). MHP terminals are responsible for mapping these colours to those used by the terminal's OSD. 

Any combination of PNGs with different colour types may be active at any one time. Similarly, terminals are responsible 
for mapping RGB 16 direct colour specifications to colours that the OSD can support. 

Table 66 : PNG Formats 



Colour Type 


Allowed Bit Depths 


Interpretation 





1,2,4,8, 16 


Each pixel is a grayscale sample. 


2 


8, 16 per component 


Each pixel is an R,G,B triple. 


3 


1,2,4,8 


Each pixel is a palette index; PLTE chunk must appear. 


4 


8, 16 


Each pixel is a grayscale sample, followed by an alpha sample. 


6 


8, 16 


Each pixel is an R,G,B triple, followed by an alpha sample. 



Where PNG graphics use colours defined in the minimum palette specified by table G.l, "Palette construction rules" on 
page 357 these colours shall be reproduced correctly. Other colours shall be reproduced on a "best effort" basis. 

Receivers should ignore gAMA (gamma) and cHRM (chromaticity) chunks in PNG files. 

15.1.1 PNG Aspect ratios 

PNG bitmaps shall carry a pHYs chunk indicating the pixel aspect ratio of the bitmap. This aspect ratio should be the 
same as that of the scene containing the bitmap. 

The PNG specification indicates that if the aspect ratio is absent square pixels should be assumed. To avoid overriding 
this specification the aspect ratio should be signalled explicitly. 

15.2 IVIinimum media formats supported by DVB-J APIs 

The following table specifies the minimum set of media types that implementations of the "Enhanced Broadcast Profile 
1 " and "Interactive Broadcast Profile 1 " shall support. It also identifies the APIs that shall provide this support: 

Table 67 : Media type support required in Enhanced and Interactive Broadcast profile 1 



Media type 


Reference 


API(s) 


Downloadable fonts 


7.4 


org.dvb.ui .Font Factory 


Audio from file 


7.1.4 


org.havi .ui .HSound 
JMF only with references to files 


MPEG 1 frame images 


7.1.1 


org . havi . ui . HBackgroundlmage 


PNG images 


7.1.1.3 


Java. awt . Image 


JPEG images 


7.1.1.2 


Java. awt . Image 


DVB service 


ETSI EN 300 46 
8 [4] 


JMF only with references to DVB services for playback direct 
from the network 


Video "drips" 


7.1.3 


org . dvb .media . DripFeedDataSource 


Text files 


7.1.5 


All Java APIs supporting reading or writing text files. 


Subtitles 


7.2.3 


JMF only as part of a DVB service 



15.3 JPEG - restrictions 

The restricted JPEG specification is as specified in 7.1.1.2, "JPEG" on page 52 except that the "progressive DCT-based" 
mode is excluded. 
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15.4 Locale support 

Support of resources for the following locales is required: 

• one guaranteed one (EN.UK) 

• zero (or more) implementation dependant ones 

Further it is guaranteed that the default Locale shall have resources. The default Locale is implementation dependant. 

15.5 Video raster format dependencies 

This section addresses the aspects of this specification that vary as a consequence of the video raster format. The formats 
names follow those used in ETSI TR 101 154 [9]. 

15.5.1 25 Hz standard definition 
15.5.1.1 Logical pixel resolution 

The logical pixel resolution shall be 72 dots per inch. 
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1 6 Registry of Constants 
16.1 System constants 



Table 68 : Registry of constants 



Entity 


Value 


Description 


PTimerMinRepeatlnterval 


40 ms 


This (or optionally a smaller) value shall be returned by javax.tv.util. 

TVTimer.getMinRepeatlnterval(). 

See 11.9.1, "Timer Support" on page 140. 


PTimerGranularity 


10ms 


This (or optionally a smaller) value shall be returned by javax.tv.util. 

TVTimer.getGranularity(). 

See 11.9.1, "Timer Support" on page 140. 



Table 69 : Profile encoding 



application 
profile 


version 


Definition 


major 


minor 


micro 


1 


1 





3 


Enhanced Broadcast Profile 1 as defined in this specification 


2 


1 





3 


Interactive Broadcast Profile 1 as defined in this specification 



16.2 DVB-J constants 

This section to be populated with the values of public final static symbols from the various Java APIs. 

16.2.1 Public and Protected final static primitive fields from DVB packages 

The following is a list of the values assigned for public and protected final static primitive fields defined in the DVB 
defined DVB-J packages: 

. AppAttributes . DVB_J_application = 1; 
■AppAttributes .DVB_HTML_application = 2; 
■AppProxy. STARTED = 0; 
■AppProxy .DESTROYED = 1; 
. AppProxy. NOT_LOADED = 2; 
■AppProxy .PAUSED = 3; 

■AppsDatabaseEvent .NEW_DATABASE = 0; 
■AppsDatabaseEvent .APP_CHANGED = 1; 
■AppsDatabaseEvent .APP_ADDED = 2; 
■AppsDatabaseEvent .APP_DELETED = 3; 
■DVBJProxy. LOADED = 5; 

public static final int org. dvb. application. DVBHTMLProxy . L0ADING=6; 
public static final int org. dvb. application. DVBHTMLProxy .KILLED=7; 

public final static int org . dvb . dsmcc . DSMCCOb ject . FROM_CACHE = 1; 

public final static int org . dvb . dsmcc . DSMCCOb ject . FROM_CACHE_OR_STREAM = 2; 

public final static int org . dvb . dsmcc . DSMCCOb ject . FROM_STREAM_ONLY = 3; 

public final static int org. dvb. event .UserEvent .UEF_KEY_EVENT = 1; 

public final static int org . dvb . io .persistent . FileAttributes . PRIORITY_LOW = 1; 
public final static int org . dvb . io .persistent . FileAttributes . PRIORITY_MEDIUM = 2; 
public final static int org . dvb . io .persistent . FileAttributes . PRIORITY_HIGH = 3; 

public final static int org. dvb. media .PresentationChangedEvent . STREAM_UNAVAILABLE = 0; 
public final static int org. dvb. media .PresentationChangedEvent . CA_FAILURE = 1; 
public final static int org . dvb .media . PresentationChangedEvent . CA_RETURNED = 2; 
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public final static int org. dvb .media . VideoFormatControl .ASPECT„RATIO_UNKNOWN = -1; 

public final static int org. dvb .media . VideoFormatControl .AFD_NOT_PRESENT = -1; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_UNKNOWN = -1; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_NONE = 0; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_FULL = 1; 

public final static int org. dvb .media . VideoFormatControl .DAR_4_3 = 1; 

public final static int org. dvb .media . VideoFormatControl .ASPECT_RATIO_4_3 = 2; 

public final static int org. dvb .media . VideoFormatControl .AFD_16_9_TOP = 2; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_LB_16_9 = 2; 

public final static int org. dvb .media . VideoFormatControl .DAR_16_9 = 2; 

public final static int org. dvb .media . VideoFormatControl .ASPECT_RATIO_16_9 = 3; 

public final static int org. dvb .media . VideoFormatControl .AFD_14_9_TOP = 3; 

public final static int org. dvb .media . VideoFormatControl .DFC„PROCESSING_LB_14_9 = 3; 

public final static int org. dvb .media . VideoFormatControl .ASPECT„RATIO_2_21_l = 4; 

public final static int org. dvb .media . VideoFormatControl .AFD_GT_16_9 = 4; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_CCO = 4; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_PAN_SCAN = 5; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_LB_2_21_l_ON_4_3 = 6; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_LB_2_21_l_ON_16_9 = 7; 

public final static int org. dvb .media . VideoFormatControl .AFD_SAME = 8; 

public final static int org . dvb .media . VideoFormatControl . DFC_PLATFORM = 8; 

public final static int org. dvb .media . VideoFormatControl .AFD_4_3 = 9; 

public final static int org. dvb .media . VideoFormatControl .AFD_16_9 = 10; 

public final static int org. dvb .media . VideoFormatControl .AFD_14_9 = 11; 

public final static int org. dvb .media . VideoFormatControl .AFD„4_3_SP_14_9 = 13; 

public final static int org. dvb .media . VideoFormatControl .AFD_16„9_SP_14_9 = 14; 

public final static int org. dvb .media . VideoFormatControl .AFD„16„9„SP_4_3 = 15; 

public final static int org. dvb .media . VideoFormatControl .DFC_PROCESSING_16_9_ZOOM = 9; 

public final static byte org. dvb .media . VideoPresentationControl .POS_CAP_OTHER = -1; 

public final static byte org. dvb .media . VideoPresentationControl .POS_CAP_FULL = 0; 

public final static byte org. dvb .media . VideoPresentationControl .POS_CAP_FULL_IF_ENTIRE_VIDEO_ON_ 

SCREEN = 1; 

public final static byte org. dvb .media . VideoPresentationControl .POS_CAP_FULL_EVEN_LINES = 3; 

public final static byte org. dvb .media . VideoPresentationControl .POS_CAP_FULL_EVEN_LINES_IF_ENTIRE_ 

VIDEO_ON_SCREEN = 4; 

public final static int org. dvb.net . re .RCInterf ace . TYPE_PSTN = 1 

public final static int org. dvb .net . re .RCInterf ace . TYPE_ISDN = 2 

public final static int org. dvb .net . re .RCInterf ace . TYPE_DECT = 3 

public final static int org. dvb .net . re .RCInterf ace . TYPE_CATV = 4 

public final static int org. dvb.net . re .RCInterf ace . TYPE_LMDS = 5 

public final static int org. dvb.net . re .RCInterf ace . TYPE_MATV = 6 

public final static int org . dvb . net . re . RCInterf ace . TYPE_RCS = 7; 

public final static int org. dvb .net . re .RCInterf ace . TYPE_UNKNOWN = 8; 

public final static int org. dvb .net . re .RCInterf ace . TYPE_OTHER = 9; 

public final static short org. dvb . si .DescriptorTag.NETWORK_NAME = 64; 

public final static short org. dvb . si .Descriptorlag. SERVICE_LIST = 65; 

public final static short org. dvb . si .Descriptorlag. STUFFING = 66; 

public final static short org. dvb . si .Descriptorlag. SATELLITE_DELIVERY_SYSTEM = 67; 

public final static short org. dvb . si .Descriptorlag. CABLE_DELIVERY_SYSTEM = 68; 

public final static short org. dvb . si .Descriptorlag. BOUQUET_NAME = 71; 

public final static short org. dvb . si .Descriptorlag. SERVICE = 72; 

public final static short org. dvb. si .Descriptorlag. COUNTRY_AVAILABILITY = 73; 

public final static short org. dvb . si .Descriptorlag. LINKAGE = 74; 

public final static short org. dvb . si .Descriptorlag. NVOD_REFERENCE = 75; 

public final static short org. dvb . si .Descriptorlag. TIME_SHIFTED_SERVICE = 76; 

public final static short org. dvb . si .Descriptorlag. SHORT_EVENT = 77; 

public final static short org. dvb . si .Descriptorlag. EXTENDED_EVENT = 78; 

public final static short org. dvb . si .Descriptorlag. TIME_SHIFTED_EVENT = 79; 

public final static short org. dvb . si .Descriptorlag. COMPONENT = 80; 

public final static short org. dvb . si .Descriptorlag. MOSAIC = 81; 

public final static short org. dvb . si .Descriptorlag. STREAM_IDENTIFIER = 82; 

public final static short org. dvb . si .Descriptorlag. CA_IDENTIFIER = 83; 

public final static short org. dvb . si .Descriptorlag. CONTENT = 84; 

public final static short org. dvb . si .Descriptorlag. PARENTAL_RATING = 85; 

public final static short org . dvb . si . Descriptorlag . TELETEXT = 86; 

public final static short org. dvb . si .Descriptorlag. TELEPHONE = 87; 

public final static short org . dvb . si . Descriptorlag . LOCAL_TIME_OFFSET = 88; 

public final static short org. dvb . si .Descriptorlag. SUBTITLING = 89; 

public final static short org. dvb . si .Descriptorlag. TERRESTRIAL_DELIVERY_SYSTEM = 90; 
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public final static short org. dvb. si .DescriptorTag.MULTILINGUAL_NETWORK_NAME = 91 

public final static short org. dvb. si .DescriptorTag.MULTILINGUAL_BOUQUET_NAME = 92 

public final static short org. dvb . si .DescriptorTag.MULTILINGUAL_SERVICE_NAME = 93 

public final static short org. dvb . si .DescriptorTag.MULTILINGUAL_COMPONENT = 94; 

public final static short org. dvb. si .DescriptorTag.PRIVATE_DATA_SPECIFIER = 95; 

public final static short org. dvb . si .DescriptorTag. SERVICE_MOVE = 96; 

public final static short org. dvb. si .DescriptorTag. SHORT_SMOOTHING_BUFFER = 97; 

public final static short org. dvb . si .DescriptorTag. FREQUENCY_LIST = 98; 

public final static short org. dvb . si .DescriptorTag. PARTIAL_TRANSPORT_STREAM = 99; 

public final static short org. dvb . si .DescriptorTag. DATA_BROADCAST = 100; 

public final static byte org. dvb . si .PMTStreamType .MPEG1_VIDE0 = 1 

public final static byte org. dvb. si .PMTStreamType .MPEG2_VIDE0 = 2 

public final static byte org. dvb . si .PMTStreamType .MPEG1_AUDI0 = 3 

public final static byte org. dvb . si .PMTStreamType .MPEG2_AUDI0 = 4 

public final static short org. dvb . si . Sllnf ormation .FROM_CACHE„ONLY = 0; 

public final static short org. dvb. si . Sllnf ormation .FROM_CACHE_OR_STREAM = 1 

public final static short org. dvb . si . Sllnf ormation .FROM_STREAM_ONLY = 2; 

public final static byte org. dvb . si . SIMonitoringType .NETWORK = 1 

public final static byte org. dvb . si . SIMonitoringType .BOUQUET = 2 

public final static byte org. dvb . si . SIMonitoringType . SERVICE = 3 

public final static byte org. dvb. si . SIMonitoringType .PMT_SERVICE = 4; 

public final static byte org. dvb. si . SIMonitoringType .PRESENT_FOLLOWING_EVENT = 5; 

public final static byte org. dvb . si . SIMonitoringType . SCHEDULED_EVENT = 6; 

public final static byte org. dvb. si . SIRunningStatus .UNDEFINED = 0; 

public final static byte org. dvb . si . SIRunningStatus .NOT_RUNNING = 1; 

public final static byte org. dvb . si . SIRunningStatus . STARTS_IN_A_FEW_SECONDS = 2; 

public final static byte org. dvb . si . SIRunningStatus .PAUSING = 3; 

public final static byte org. dvb . si . SIRunningStatus .RUNNING = 4; 

public final static short org. dvb . si . SIServiceType .UNKNOWN = -1; 

public final static short org. dvb . si . SIServiceType .DIGITAL_TELEVISION = 1; 

public final static short org . dvb . si . SIServiceType . DIGITAL_RADIO_SOUND = 2; 

public final static short org. dvb . si . SIServiceType . TELETEXT = 3; 

public final static short org. dvb . si . SIServiceType .NVOD_REFERENCE = 4; 

public final static short org. dvb . si . SIServiceType .NVOD_TIME_SHIFTED = 5; 

public final static short org. dvb . si . SIServiceType .MOSAIC = 6; 

public final static short org. dvb . si . SIServiceType .PAL = 7; 

public final static short org. dvb . si . SIServiceType . SECAM = 8; 

public final static short org. dvb . si . SIServiceType .D_D2_MAC = 9; 

public final static short org. dvb . si . SIServiceType .FM_RADIO = 10; 

public final static short org. dvb . si . SIServiceType .NTSC = 11; 

public final static short org. dvb . si . SIServiceType .DATA_BROADCAST = 12; 

public final static short org. dvb . si . SIServiceType .MHP_APPLICATION = 16; 

public final static int org. dvb .test .DVBTest .UNTESTED = -5; 

public final static int org. dvb .test .DVBTest .UNRESOLVED = -4; 

public final static int org. dvb .test .DVBTest .HUMAN_INTERVENTION = -3; 

public final static int org. dvb .test .DVBTest .OPTION_UNSUPPORTED = -2; 

public final static int org. dvb .test .DVBTest .FAIL = -1; 

public final static int org. dvb .test .DVBTest .PASS = 0; 

public final static int org. dvb. ui .DVBAlphaComposite . CLEAR = 1; 

public final static int org. dvb. ui .DVBAlphaComposite . SRC = 2; 

public final static int org. dvb. ui .DVBAlphaComposite . SRC_OVER = 3; 

public final static int org. dvb. ui .DVBAlphaComposite .DST_OVER = 4; 

public final static int org. dvb .ui .DVBAlphaComposite . SRC_IN = 5; 

public final static int org. dvb .ui .DVBAlphaComposite .DST_IN = 6; 

public final static int org. dvb .ui .DVBAlphaComposite . SRC_OUT = 7; 

public final static int org. dvb .ui .DVBAlphaComposite .DST_OUT = 8; 

public final static int org. dvb .ui .DVBBuf feredlmage . TYPE_ADVANCED = 20; 

public final static int org. dvb .ui .DVBBuf feredlmage . TYPE_BASE = 21; 

public final static int org . dvb . ui . DVBTextLayoutManager . HORIZONTAL_START_ALIGN = 1; 

public final static int org. dvb .ui .DVBTextLayoutManager .HORIZONTAL_END_ALIGN = 2; 

public final static int org. dvb .ui .DVBTextLayoutManager .HORIZONTAL_CENTER = 3; 

public final static int org. dvb. ui .DVBTextLayoutManager .VERTICAL_START_ALIGN = 4; 

public final static int org. dvb. ui .DVBTextLayoutManager .VERTICAL_END_ALIGN = 5; 

public final static int org. dvb .ui .DVBTextLayoutManager .VERTICAL_CENTER = 6; 

public final static int org . dvb . ui . DVBTextLayoutManager . LINE_ORIENTATION_HORIZONTAL = 10; 

public final static int org. dvb .ui .DVBTextLayoutManager . LINE_ORIENTATION_VERTICAL = 11; 

public final static int org . dvb . ui . DVBTextLayoutManager . START_CORNER_UPPER„LEFT = 20; 

public final static int org. dvb. ui .DVBTextLayoutManager . START_CORNER_UPPER_RIGHT = 21; 

public final static int org. dvb .ui .DVBTextLayoutManager . START_CORNER_LOWER_LEFT = 22; 
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public final static int org. dvb.ui .DVBTextLayoutManager . START_CORNER_LOWER_RIGHT = 23; 

16.2.2 Public and Protected final static primitive fields from standard Java 
packages 

These constants are recorded in the following documents: 

• JAE 1.1.8 const [72] 

• JAE 1.2.2 const [73] 

• JMF const [74] 

NOTE: The constants for Java TV [51] are within that specification. JSSE [60] introduces no constants. 
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Annex A (normative): External references; errata, 
clarifications and exemptions 

This section lists known errata in normative external references, as well as clarifications to those references and/or 
exemptions from requirements in those specifications. 

A.1 JAE 1.1.8 API [31] 

A.1 .1 java.lang.ThreadGroup.getParentQ 

This specification is considered to include: 

This method may throw a security exception. 

A.1 .2 java.net.URLconnection.setFileNameMap 

The method Java . net . URLconnection . setFileNameMap is considered to specify: 

If there is a security manager, its checkSetFactory method is called with no arguments. This may result in a 
security exception. 

A.1 .3 Java. util. Locale. setDefault 

This specification is considered to include: 

This method may throw a security exception. 

A.1. 4 Java. lang. Class 

The following clarifications are considered to be part of this specification: 

Reflective operations, such as Class. forName(String) shall cause class initialization of the given class, if the call 
succeeds and the class had not previously been initialized. 

A. 1.5 Java. awt. Font 

Where an MHP terminal does not have available a font matching the specification of the parameters passed to the 
constructor of the j ava . awt . Font class, the implementation shall silently approximate to a font which is 
available. No runtime error or exception shall be thrown by the constructor. The approximation shall not be visible to 
implementations through any of the methods on the returned instance of Java . awt . Font. 

A.1. 6 java.io.PrintStream 

The two constructors PrintStream (OutputStream) and PrintStream (OutputStream, boolean) , are 
considered to not be deprecated, and are therefore required to be present on an MHP terminal. 

A.1. 7 java.io.Serializable 

NOTE: This specification does not have standardised external forms for serializable classes. Thus 

applications cannot rely on using serialization for transmitting data into or out of a specific MHP 
terminal. Use of Serialized objects with persistent storage shall work as specified where 
applications have the required permissions however using this is not recommended. 

A.1 .8 java.io.ObjectStreamConstants 

The interface Java . io .Ob jectStreamConstants implemented by Java . io . Ob ject Input St ream is not 
part of this specification. 
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A.1.9 java.net.SocketOptions 

The interface Java . net . Socket Opt ions implemented by Java . net . Socket Imp 1 is not part of this 
specification. 

A.1.10 java.util.zip.ZipConstants 

The interface Java . util . zip . ZipConstants implemented by Java . util . zip . ZipEntry, Java . util . 
zip . ZipFile and Java . util . zip . ZipInputStream is not part of this specification. 

A.1.11 Component 

The specification of Component . getGraphics in JAE 1.1.8 API [31] is considered to read: 

/** 

* Creates and returns a graphics context to be used for 

* rendering directly to this component. 

* Returns <code>null</code> if this component is currently not 

* displayable. 

* The returned object is a graphics context that causes drawing to the output device of this 
component; 

* in other words, it is the same whether or not 

* double buffering is enabled on this component. 

* When you have finished using the graphics context 

* returned by this method, 

* you should invoke the <code>dispose</code> method on it. 

* @return a graphics context for this component, or <code>null</code> 

* if it has none 

* @see #paint 

* @see Graphics#dispose 

* @since JDKl . 
*/ 

A.1.12 java.awt.event.KeyEvent 

The constructor: 

KeyEvent(Component, int, long, int, int) 
shall be considered to be deprecated. 

A. 1.1 3 java.awt.Component 

A. 1.1 3.1 java.awt.Component.update(Graphics) 

The following text: 

The AWT calls the update method in response to a call to repaintupdate or paint. You can assume that the 
background is not cleared. 

Is considered to be replaced by: 

If this component is not a lightweight component, the AWT calls the update method in response to a call to 
repaint. You can assume that the background is not cleared. 

A. 1.1 3. 2 java.awt.Component.repaint() 

The following text: 

This method causes a call to this component's update method as soon as possible. 
Is considered to be replaced by: 

If this component is a lightweight component, this method causes a call to this component's paint method as soon 
as possible. Otherwise, this method causes a call to this component's update method as soon as possible. 
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A.1.13.3 java.awt.Component.repaint(long) 

The following text: 

Repaints the component. This will result in a call to update within tm milliseconds. 
Is considered to be replaced by: 

Repaints the component. If this component is a lightweight component, this will result in a call to paint within tm 
milliseconds. 

Otherwise, this will result in a call to update within tm milliseconds. 

A.1.13.4 java.awt.Component.repaint(int, int, int, int) 

The following text: 

This method causes a call to this component's update method as soon as possible. 
Is considered to be replaced by: 

If this component is a lightweight component, this method causes a call to this component's paint method as soon 
as possible. Otherwise, this method causes a call to this component's update method as soon as possible. 

A.1.14 java.lang.Thread 

The specification of Thread. checkAccess in JAE 1.1.8 API [31] is considered to be marked as final. 

A. 1.1 5 Java. lang. Object 

The definitions of hashCode() and equalsQ shall be as for JDK 1.2.2 [78]. 

A. 1.1 6 java.awt.Graphics 
A.I. 16.1 drawBytes(byte[], ...) 

NOTE: The character encoding used to convert the bytes into a string is unspecified, and might vary by 
platform implementation. 

A. 1.1 7 Java. lang. Character 

The following text in the class description: 

The Unicode attribute table is available on the World Wide Web as the file: 
ftp://unicode.org/pub/MappingTables/UnicodeDatal . 1 . 5.txt 
Shall be considered to be replaced with: 

The character attribute tables for specific versions of Unicode are available on the World Wide Web in various 
subdirectories of: 

ftp://ftp.unicode.org/Public/ 

A. 1.1 8 java.awt.FontMetrics 

The method Java . awt .FontMetrics .bytes Width (byte [ ] , int, int ) shall use the default character 
encoding for the platform, as defined in 1 1.2.1 1, "Text Encodings" on page 106. 

A. 1.1 9 General 

A.1.19.1 Unicode version exemption 

In the MHP specification, it is an allowed implementation option to use a future version of the Unicode specification 
more recent than the one specified by JAE 1.1.8 API [31]. 
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MHP terminals supporting user input of characters not found in the version of Unicode specified by JAE 1.1.8 API [31] 
should use a sufficiently recent version of the Unicode specification to support those characters, e.g. for the purposes of 

Java . awt . event . KeyEvent . getKeyChar. 

NOTE: Application developers should be careful when using parts of JAE like the methods on j ava . 
lang. Character which Unicode characters which have been subject to a non-backwards 
compatible change between Unicode 2.0 and Unicode 3.0. 

A.1 .20 java.net.MulticastSocket.setlnterface 

The following sentence: 

Set the outgoing network interface for multicast packets on this socket, to other than the system default. 

Shall be considered to read: 

Set the multicast network interface used by methods whose behavior would be affected by the value of the 
network interface. 

A.2 Java Language Spec [32] 

A.2.1 java.lang.ThreadGroup.getParentQ 

This method may throw a security exception. 

A.2. 2 Java. lang. Runtime. runFinalizersOnExitO 

This method may throw a SecurityException 

A.2. 3 Java. lang. System. runFinalizersOnExitO 

This method may throw a SecurityException 

A.3 Java Media Player Specification [33] 

A.3.1 javax.media. protocol. URLDataSource. sources 

The j avax. media, protocol .URLDataSource . sources field shall be considered not to be present. So, any 
reference to it will fail. 

A.3. 2 javax.media. protocol. ContentDescriptor 
A.3.2.1 getContentType 

This method shall return the string passed into the constructor; which is defined to be a MIME type. 

A.3. 2. 2 mimeTypeToPackageName 

This method is considered to have "public" visibility. 

A.4 JavaVI\/l[34] 

The following clarifications are considered to be part of this specification: 

• As described in sections 12.1.2 and 12.3.1 of Java Language Spec [32], class file verification is mandatory for all 
implementations that conform to Java VM [34]. 

• Resolving a class causes its superinterfaces to be resolved. 

• As specified in section 13.1 of Java Language Spec [32], the target of the invokeinterface instruction's method 
invocation must support the referenced interface. If it does not, an IncompatibleClassChangeError shall be raised 
when the invokeinterface instruction is executed. 
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NOTE: This is described on page 282 of Java VM2 [F]. 
Additionally for MHP terminals: 

• MHP terminals are exempt from implementing class finalization, as required by section 2.16.8 of Java VM [34]. 

NOTE: As noted in the appendix of Java VM2 [F], class finalization has not been implemented, and it is not 
required in the 2nd edition of the VM specification. 

On the top of page 123 of Java VM [34], the following bullet point is considered to be present: 

• The type of every class instance that is the target of a method invocation instruction must be assignment 
compatible (2.6.6) with the class or interface type specified in the instruction. In addition, the type of the target of 
an invokespecial instruction must be assignment compatible with the current class. 

A.5 Java TV [51] 

The following is considered to be present: 

All methods in JavaTV whose name is of the form removeXXXXListener, shall have no effect if the listener 
concerned is not registered. 

A.5.1 javax.tv.service. selection 
A.5.1 .1 PresentationTerminated Event 

The following specification additions are considered to be present: 

When a call to ServiceContext . select ( ) fails for a service context in the not presenting state, the 
following table defines how the reason code for the Present at ionTerminatedEvent shall be derived from 
the reason code of the SelectionFailedEvent which first notified applications of the failure of the method 
call. 

Table A.1 : Reason code mapping 



SelectionFailedEvent reason code 


PresentationTerminatedEvent reason code 


CA_REFUSAL 


ACCESS_WITHDRAWN 


CONTENT_NOT_FOUND 


SERVICE, VANISHED 


INSUFFICIENT_RESOURCES 


RESOURCES_REMOVED 


MISSING_HANDLER 


RESOURCES_REMOVED 


TUNING, FAILURE 


TUNED_AWAY 



No equivalent of the reason code SelectionFailedEvent . INTERRUPTED shall be generated for service 
contexts formerly in the not_presenting state since by definition, another selection is in process on the 
service context concerned. 

In the definition of the USER_STOP code, replace "The user" with "An application or the end user. 

A.5.1 .2 ServiceContext.select( Locator [] ) 

a) The following text shall be considered as being added to the end of the description of this method. 

If the content corresponding to any of the locators specified can be successfully presented then the selection 
operation shall be considered to have succeeded even if attempts to present content corresponding to other 
locators failed. If different locators failed for different reasons then the reason code is implementation dependent. 

b) Replace the following text: 

Successful completion of a select operation using this method provides ServiceContentHandler instances 
for all components that are indicated in the components parameter. 

with 

Successful completion of a selection operation using this method provides ServiceContentHandlers for 
those components indicated in the components parameter which were successfully presented. 
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c) The following shall be added to the Throws InvalidLocatorException clause: 

For locators which reference a service component which is not selectable and where there is no 
ServiceContentHandler defined, the exception shall be thrown if the error condition can be detected without 
causing the method to block. For example, implementations shall not block waiting for network access or tuning 
where this is required to discover whether a specific locator references a selectable service component and there is 
a ServiceContentHandler. Where such an error condition is discovered after the return from this method, a 
SelectionFailedEvent with reason code MISSING_HANDLER shall be generated. 

A.5. 1 .3 ServiceContext.getServiceContentHandlers 

The following text is considered to be added to the end of the main body of the method description; 

When a service with no components is selected, the ServiceContext shall generate a 
NormalContentEvent and enter the PRESENTING state. 

NOTE: A zero length array may also be returned if the currently selected service has no components at all. 
For example, a service which is only on-air for part of day and presently has no video, audio or 
applications. 

NOTE: Applications cannot assume anything about the order of the ServiceContentHandlers returned by 
this method. 

A zero length array shall also be returned in the case of ServiceContexts which are in the presenting state and but where 
the service components are of a type which has no ServiceContentHandler defined. 

A.5.1.4 ServiceContextPermission 

The following text; 

From a security standpoint, a caller is said to "own" a ServiceContext instance if it was acquired through 
ServiceContextFactory.createServiceContext() or ServiceContextFactory.getServiceContext(javax.tv.xlet. 
XletContext). 

shall be considered to be replaced by: 

A callers "own" service contexts are those which it has created through ServiceContextFactory. 
createServiceContext(). If an Xlet would have a ServiceContext returned should it call ServiceContextFactory. 
getServiceContext(iavax.tv.xlet.XletContext) then that ServiceContext is also considered to be one of its "own". 

A.5.2 javax.tv.util.TVTimer 

A.5.2. 1 scheduleTimerSpec(TVTimerSpec) 

The following specification changes are considered to be present: 

Replace: 

If you schedule an absolute specification that should have gone off already, it will go off immediately. 
With: 

If you schedule an absolute specification that should have gone off already, it will go off immediately, and the 
return value of this method will be an absolute specification reflecting the current absolute time. 

The following text: 

If you schedule an absolute specification that should have gone off already, it will go off immediately. 
Shall be considered to read: 

If you schedule an absolute specification that should have gone off already, it will immediately be eligible to go 
off though the actual listener notification may happen asynchronously. 



ETSI 



242 ETSITS 101 812V1.3.1 (2003-06) 

In TVTimer . scheduleTimerSpec, the following sentence should be considered to be appended to the method 
description: 

The platform may modify the values in the timer spec during the execution of this method. A delayed TimerSpec 
may be transformed into an absolute TimerSpec. 

A.5.2.2 deschedule(TVTimerSpec) 

In TVTimer.deschedule, the following paragraph is considered to be appended to the method description: 

No other instances of timer specifications shall be descheduled. 
In TVTimer.deschedule, the parameters section is considered to read: 

t - The timer specification to end monitoring. This shall be an instance returned from the method TVTimer. 
schedule on this instance of TVTimer. If it is not, this method shall have no effect. 

A.5.3 javax.tv.util.TVTimerSpec 
A.5.3.1 setAbsoluteTime(long) 

The following specification additions are considered to be present: 

If the time parameter passed is negative, this method shall throw an IllegalArgumentException. 

A.5.3.2 setTime(long) 

The following specification additions are considered to be present: 

If the time parameter passed is negative, this method shall throw an IllegalArgumentException. 

A.5.4 javax.tv.xlet.Xlet 
A.5.4.1 Xlet state descriptions 

In the table of xlet state descriptions in the package description of the j avax . tv . xlet package, the description of the 
loaded state is considered to be modified as follows. 

Replace "created using new" with "created using Class.newlnstance". 

A.5.4.2 initXIet 

The sentence: 

After this method returns successfully, the Xlet is in the Paused state and should be quiescent, 
shall be considered to read: 

After this method returns successfully, assuming that the Xlet is still in the Loaded state, it shall transition to the 
Paused state and should be quiescent. 

A.5.5 javax.tv.graphics.AlphaColor 

The following features imply dependencies on Java 2 and are therefore not considered to be present in this specification: 

• the createContext method listed under "Methods inherited from java.awt.Color" 

• the Java . awt . Transparency interface listed under "All Implemented Interfaces:" 

• the fields listed under "Fields inherited from interface java.awt.Transparency" 

• the j ava . awt . Paint interface listed under "All Implemented Interfaces:" 
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A.5.6 javax.tv.media.MediaSelectControl 
A.5.6.1 addMediaSelectListener 

The following specification addition is considered to be present 

If the specified listener is currently subscribed, no action is performed. 

A.5.6. 2 Class Description 

The description of this class shall be considered to have the following additional paragraph. 

Applications should note that the set of selected service components can be changed by other entities apart from 
themselves. Such changes will be reported by a MediaSelectEvent being sent if a 
MediaSelectListener is currently registered. 

A.5.6. 3 All methods throwing InvalidServiceComponentException 

In all methods throwing InvalidServiceComponentException, the following text 

If the specified service component is not part of the Service to which the MediaSelectControl is restricted 
Shall be considered to be replaced with: 

If the specified service component is not part of the Service or Services to which the MediaSelectControl is 
restricted 

A.5.7 javax.tv.graphics.TVContainer 
A.5.7.1 getRootContainer 

The returns clause of this method is considered to be prefixed with the following: 

On the first occasion this method is called for a particular xlet, 
The returns clause is considered to have the following text added to it: 

On subsequent calls to this method for a particular xlet, the implementation shall return the container without 
modifying it. 

A.5.8 javax.tv.service. navigation. ServiceLlst 

The sorting algorithm used for the method ServiceList . sortByName shall be implementation dependent. The 
result should be something sensible when presented to an end-user of the MHP terminal. 

A.5.9 javax.tv.service. SIManager 
A.5.9.1 getService 

The text in the method description "referred to by a given locator" shall be considered to be "identified by a given 
locator". 

The text in the parameters clause "specifying a service" shall be considered to be "identifying a service". 

The text in the throws clause "does not reference a valid service" shall be considered to be "does not contain sufficient 
information to identify a service". 

A.5.9.2 retrieves! Element 

On some implementations of JavaTV, attempts to retrieve a ProgramEvent will always fail with an 

SIRequestFailureType ( INSUFFICIENT_RESOURCES) . 
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A.5.9.3 retrieveProgram Event 

On some implementations of JavaTV, attempts to retrieve a ProgramEvent will always fail with an 

SIRequestFailureType (INSUFFICIENT_RESOURCES) . 

A.5.10 javax.tv.service.SIEIement.getServicelnformationType 

This method is considered to have the following text at the end of the method description: 

NOTE: In the case where an SI format is in use which is not encoded as one of the set of values defined as 
constants in the class ServicelnformationType, the value returned may be outside this set of values. 

A.5.1 1 retrieveProgramEvent(Locator,SIRequestor) 

The following text is assumed to form part of this method description: 

On some implementations of JavaTV, attempts to retrieve a ProgramEvent will always fail with an 
SIRequestFailureType(INSUFFICIENT_RESOURCES). 

A.6 DAVIC1.4.1p9[3] 

A.6.1 org.davic.mpeg 
A.6.1.1 General 

The following classes are considered to have a no argument protected constructor: 

• ElementaryStream 

• Service 

• TransportStream 

A.6. 1.2 NotAuthorized Exception 

The specification is considered to include org. davic .mpeg. Not Author izedExcept ion as specified below: 
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org.davic.mpeg 

NotAuthorized Exception 



Syntax 

public class NotAuthorizedException extends j ava . lang. Exception implements org.davic.mpeg. 
NotAuthorizedlnterf ace 

Java . lang . Ob ject 

H Java . lang . Throwable 

I 

H Java . lang .Exception 

H — org . davic . mpeg . NotAuthorizedException 

All Implemented Interfaces: 

NotAuthorizedlnterf ace, java.io.SeriaNzable 

Description 

This class is tinrown by IVIPEG related APIs when access is requested to information which is scrambled 
and to which access is not permitted by the security system. 



Constructors 

NotAuthorizedExceptionO 

public NotAuthorizedExceptionO 

Constructs a NotAuthorizedException with no detail message 
NotAuthorizedException(String) 

public NotAuthorizedException (j ava . lang . String s) 

Constructs a NotAuthorizedException with the specified detail message 

Parameters: 

s - the detail message 



Methods 

getElementaryStreamsQ 

public ElementaryStream[ ] getElementaryStreams ( ) 

If getTypeQ returns ELEMENTARY_STREAM, then this method returns the set of Elementa- 
ryStreams that could not be descrambled. Otherwise it returns null. 

Specified By: 

NotAuthorizedlnterf ace . getElementaryStreams {) In Interface NotAuthorizedlnterf ace 

Returns: 

either the set of ElementaryStreams that could not be descrambled or null 
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getReason(int) 

public int[ ] getReason (int index) 

Returns the reason(s) why descrambling was not possible. 
Specified By: 

NotAuthorizedlnterface .getReason (int) in interface NotAuthorizedlnterf ace 

Parameters: 

index - If the component to which access failed is a Service, index shall be 0. Otherwise index 
shall refer to one stream in the set returnedby getElementaryStreamsQ. 

Returns: 

an array of length 2 where the first element of the array is the major reason and the second 
element of the array is the minor reason. 

Throws: 

indexOutOf BoundsException - If the component to which access failed is a Service, this 
exception will be thrown if index is non zero. If the component(s) to which access failed was a 
(set of) elementary streams then this exception will be thrown where index is beyond the size of 
the array returned by getElementaryStreams. 

See Also: 

NotAuthorizedlnterface . getElementaryStreams ( ) 

getServiceO 

public Service getServiceO 

If getTypeO returns SERVICE, then this method returns the Service that could not be descrambled. 
Otherwise it returns null. 

Specified By: 

NotAuthorizedlnterface .getService () In Interface NotAuthorizedlnterface 

Returns: 

either the Service that could not be descrambled or null 

getTypeO 

public int getTypel) 

Specified By: 

NotAuthorizedlnterf ace. getType {) In Interface NotAuthorizedlnterface 

Returns: 

SERVICE or ELEMENTARY_STREAM to indicate that either a service (MPEG program) or one 
or more elementary streams could not be descrambled. 



A.6.2 Chapter 9, Application Format 

A.6.2. 1 Section 9.4.7. "The MPEG-2 Section Filter API" 

In the description of this class there are 2 instances of a cross reference to DAVIC part 10, section 1 15.3. In each case this 
shall be considered as a reference to DAVIC part 10, section 12.5.3. 
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A.6.3 org.davic.mpeg.dvb 
A.6.3.1 General 

The following classes are considered to have a no argument protected constructor: 

• DvbService 

• DvbElementaryStream 

• DvbTransportStream 

A.6.4 org. davic.mpeg. sections 
A.6.4.1 RingSectionFilter 

Is considered to have the following text appended to its description: 

All sections in a ring section filter are initialised to empty when the ring section filter is first created. Clearing 
them to empty any time after this is the responsibility of the application. Starting a ring section filter shall not 
clear any of the sections to empty. 

A.6.4.2 Section 

A.6.4.2.1 cloneQ 

Section is considered to have the method clone() with the following behaviour. 

A cloned Section object is a new and separate object. It is unaffected by changes in the state of the original 
Section object or restarting of the SectionFilter the source Section object originated from. The clone method must 
be implemented without declaring exceptions. 

A.6.4.2.2 getDataO 

Remove the following text from the methods of org. davic .mpeg. sections . Section: 

(everything after the length field, not including a CRC check) 
A.6.4.2.3 getFullStatusQ 

Is considered to have the following text appended to its description: 

Returns true when the Section object contains valid data. 

A.6.4.2.4 Class Description 

The following text shall be considered to be present at the end of the class description. 

In this class, the term "section data" shall be considered to include the section header, any possible CRC and all 
bytes in between. 

A.6.4.3 SectionFilter 

A. 6. 4. 3.1 Cross reference error 

In the description of this class there are 12 instances of a cross reference to H7. In each case this shall be considered as a 
reference to E.8.1. 

A. 6. 4. 3. 2 startFiltering( all signatures ) 

In these methods, the description of when the FilterResourceException shall be thrown is considered to have 
the following text appended to its description: 

This shall be applied whether the parent section filter group is connected to a TS or not, or whether this 
SectionFilter object is already started or not. 
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A. 6. 4. 3. 3 startFiltering(java.lang. Object, int, int, int, byte[], byte[]) 

Is considered to have the following text appended to its description: 

IllegalFilterDef initionException is thrown if offset is too small. 

A. 6. 4. 3. 4 startFiltering (appData, pid, tableld) exceptions 

Like other startFiltering methods org . davic .mpeg . sections . Sect ionFi Iter . startFiltering 
(appData, pid, tableld) shall throw an IllegalFilterDef initionException where: 

• the Java integer is negative 

• the Java integer is larger than what is allowed for PID or table_id according to the relevant MPEG specification 
A.6.4.3.5 Started Section Filters 

The class description is considered to have the following text added at its end. 

When a SectionFilterGroup is detached, either by the client or through resource withdrawal, started SectionFilters 
shall remain started. Hence if the SectionFilterGroup is re-attached, those filters shall re-activate. 

A.6.4.4 SectionFilterGroup 

A.6.4.4.1 attacii 

A NotAuthorizedException is added to the definition of this method. 

A.6.4.4.2 Constructors 

The constructors are considered to have. 

Throws IllegalArgumentException if numberOf Filters <1. 

A.6.4.4. 3 sectionSize 

All methods with a sectionSize parameter are considered to have the following text appended to their descriptions: 
Throws IllegalArgumentException if sectionSize <1. 

A.6.4.4.4 newRingSectionFilter 

Is considered to have the following text appended to its description: 

Throws IllegalArgumentException if ringSize <1. 

A. 6. 4. 4. 5 Constructor(int, boolean) 

Is considered to have the following text appended to its description: 

The scope of the resourcePriority shall be a single application only. 

A.6.4.5 TimeOutEvent 

The specification is considered to include org. davic .mpeg. sections . TimeOutEvent as specified below: 
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org. davic.mpeg. sections 

TimeOutEvent 



Declaration 

public class TimeOutEvent extends org . davic .mpeg . sections .EndOfFilteringEvent 

Java . lang . Ob ject 

+ — Java . util . EventOb ject 
I 
-I org . davic .mpeg .sect ions. org. davic .mpeg . sections . SectionFilterEvent 

H org . davic .mpeg .sections. org. davic .mpeg .sections. EndOfFilteringEvent 

I 

+- -org. davic. mpeg. sections .TimeOutEvent 

All Implemented Interfaces: 

java.io.Serializable 

Description 

This event is generated if section filter operations time out within the period specified by the setTimeOut() method. 
For a SimpleSectionFilter it will be generated if no sections arrive within the specified period. For a 
Tables ectionFilter, it will be generated if the complete table does not arrive within the specified time. For a 
RingSectionFilter, it will be generated if the specified time has elapsed since the arrival of the last section being 
successfully filtered. 



Constructors 

TimeOutEvent(SectionFilter, Obj ect) 

public TimeOutEvent (SectionFilter f, Java . lang . Ob ject appData) 

This constructs an TimeOutEvent event for the specified SectionFilter object. 

Parameters: 

f - tine SectionFilter object which timed out 

appData - application data that was passed to the startFiltering method 



Methods 

getSourceO 

public Java. lang. Ob ject getSource ( ) 

This returns the SectionFilter object which timed out 

Overrides: 

EndOfFilteringEvent . getSource ( ) in class EndOfFilteringEvent 
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A.6.5 Simple Section Filter 

The description of the getSection method shall be considered to have the following text added: 

This method shall return null if no section has been successfully filtered for this instance and the owning 
SectionFilterGroup is not attached. 

A.6.6 org.davic.media 
A.6.6.1 FreezeControl.resumeO 

Add the following to the description of the semantics for this method: 

If the player is started and if decoding of the media stream is not frozen then calls to this method shall have no effect. If 
the player is not started then the exception shall be thrown. 

A.6.6. 2 MediaTimePositionChangedEvent 

Add the following constructor: 

MediaTimePositionChangedEvent ( 
Controller from, 
int previous, 
int current, 
int target. 
Time mediaTime) 

With the following definition of parameters: 

Parameters: 

from - the controller whose media position was changed 

previous - the state the controller was in before this event 

current - the state the controller was in at the time the event was generated 

target - the state that the controller is heading to 

mediaTime - the media time after the change 

A.6.6. 3 NotAuthorizedMediaException 

The following constructors are considered to be removed from the specification: 

NotAuthorizedMediaException () 
NotAuthorizedMediaException (Java. lang. String reason) 

The following constructors are considered to be a normative part of the specification: 

NotAuthorizedMediaException ( org . davic .mpeg . Service, int reason ) 
NotAuthorizedMediaException ( org . davic .mpeg . ElementaryStream [] , int reason[] ) 
NotAuthorizedMediaException ( org . davic .mpeg . ElementaryStream [] , int [ ] , int [ ] ) 
NotAuthorizedMediaException (Service, int ma jor_reason, int minor_reason) 

NotAuthorizedMediaException(ElementaryStream[], int[]) 

public NotAuthorizedMediaException (org . davic .mpeg . ElementaryStream [ ] e, int[] reason) 

Constructor for exception due to failure accessing one or more MPEG elementary streams The caller of this 
constructor is responsible for ensuring the two arrays provided as parameters are the same size. The implemen- 
tation is not expected to check this. The exception has no detail message. 

Parameters: 

e - the elementary streams which could not be accessed 

reason - the reason why the exception was thrown for each elementary stream 
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Use of the constructor NotAuthorizedMediaException(ElementaryStream[] e, int[] reason) will result in the 
major reason for each elementary stream being the one specified in the reason parameter to the method and the 
minor reason being OTHER as defined in NotAuthorizedlnterface. 

NotAuthorizedMediaException(Service, int) 

public NotAuthorizedMediaException (org . davic .mpeg . Service s, int reason) 

Constructor for exception due to failure accessing an MPEG service. The exception has no detail message. 

Parameters: 

s - the service which could not be accessed 

reason - the reason why the service could not be accessed 

Use of the constructor NotAuthorizedMediaException(Service, int reason) will result in the major reason for 
the service being the one specified in the reason parameter to the method and the minor reason being OTHER 
as defined in NotAuthorizedlnterface. 

NotAuthorizedMediaException(ElementaryStream[], int[], int[]) 

NotAuthorizedMediaException (ElementaryStream [ ] e, int[] ma jor_reason, int [ ] minor_reason) 

Constructor for exception due to failure accessing one or more MPEG elementary streams The caller of this 
constructor is responsible for ensuring the three arrays provided as parameters are the same size. The imple- 
mentation is not expected to check this. 

Parameters: 

e - the elementary streams which could not be accessed 

ma j or_reason - the major reason why the exception was thrown for each elementary stream 
minor_reason - the minor reason why the exception was thrown for each elementary stream 

NotAuthorizedMediaException(Service, int, int) 

public NotAuthorizedMediaException (org . davic .mpeg . Service s, int ma jor_reason, int minor_ 
reason) 

Constructor for exception due to failure accessing an IViPEG service 

Parameters: 

s - tiie service winicin could not be accessed 

major_reason - the major reason why the service could not be accessed 
minor_reason - the minor reason why the service could not be accessed 

Since: 

MHP 1.0.2 



A.6.6.4 LanguageControl 

The following description of semantics is considered to be present: 

If more than one stream with the same language exists, the behaviour of selectLanguage ( String) is to 
select the first listed in the network signalling. 

NOTE: This is equivalent to item b under 11. 4. 2. 3, "Default media player behaviour" on page 1 17. 

If no content of the appropriate media type for the control is present, a String of length zero is returned. 
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A.6.7 org.davic.net 

A.6.7.1 InvalidLocatorException 

The following class definition is considered to be a normative part of the specification: 

org.davic.net 

InvalidLocatorException 



Syntax 

public class InvalidLocatorException extends Java . lang. Exception 

Java . lang . Ob ject 

H Java . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . davic . net . InvalidLocatorException 

All Implemented Interfaces: 

java.io.Serializable 

Description 

This exception is thrown when one or more parameters to construct a Locator are invalid. 



Constructors 

InvalidLocatorExceptionO 

public InvalidLocatorException ( ) 

Constructor without reason. 
InvalidLocatorException(String) 

public InvalidLocatorException (Java . lang. String reason) 

Constructor for the exception with a specified reason 

Parameters: 

reason - the reason why the exception was raised 

A.6.7.2 Locator 

A.6.7.2.1 LocatorO 

The no-argument constructor for org . davic . net . Locator is considered to not be present. The absence of any 
description on the method indicates that this was an editing error in the DAVIC specification. 
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A.6. 7.2.2 toExternalFormO 

Is considered to have the following text appended to its description: 

If the instance of Locator has been created using Locator (Java. lang. String url) and the URL is a 
non-null invalid URL the behaviour is implementation dependent. 

A.6.7.3 tuning 

A.6.7.3.1 NetworklnterfaceController 

A.6.7.3. 1.1 reserveO 

The semantic of the following throws clause is corrected as follows: 

Throws: NoFreelnterf aceException 

raised if the requested network interface can not be reserved 

The following from the semantic of this method: 

If this NetworklnterfaceController has already reserved another Networklnterface, then it will either release that 
Networklnterface and reserve the specified one, or throw an exception. If the specified Networklnterface has 
already been reserved by this NetworklnterfaceController, then this method does nothing. 

is replaced with the following: 

If this NetworklnterfaceController has currently reserved another Networklnterface, then it will either release that 
Networklnterface and reserve an appropriate one, or throw an exception. If a Networklnterface that is able to tune 
to the specified transport stream is currently reserved by this NetworklnterfaceController, then this method does 
nothing. 

A.6.7.3. 1.2 reserveForO 

The following from the semantic of this method: 

If this NetworklnterfaceController has already reserved another Networklnterface, then it will either release that 
Networklnterface and reserve an appropriate one, or throw an exception. If NetworklnterfaceController has 
already reserved a Networklnterface that is able to tune to the specified transport stream, then this method does 
nothing. 

is replaced with the following: 

If this NetworklnterfaceController has currently reserved another Networklnterface, then it will either release that 
Networklnterface and reserve an appropriate one, or throw an exception. If a Networklnterface that is able to tune 
to the specified transport stream is currently reserved by this NetworklnterfaceController, then this method does 
nothing. 

A.6.7.3. 1.3 tuneO 

Replace "this Networklnterface" with "the Networklnterface reserved by this NetworklnterfaceController" in section H. 
5.4.3 of DAVIC specification. 

A.6.7.3.2 Networklnterface 

A.6.7. 3.2.1 Protected constructor 

This class is considered to have a no argument protected constructor with the following statement attached to it: 

This constructor is provided for the use of implementations and specifications which extend this specification. 
Applications shall not define sub-classes of this class. Implementations are not required to behave correctly if any 
such application defined sub-classes are used. 
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A.6.7.4 ca 

A.6. 7.4.1 CAMessage 

The following class definition is considered to be a nonnative part of the specification: 

public class CAMessage 
extends Java . lang. Object 

This class represents messages to CA modules. 
Constructors 

public CAMessage (byte [] data) 

Constructor for the message 

Parameters: 

data - message data 

Method Detail 

getData 

public byte[] getData() 

Returns: 

the data of the message 

A.6.7.4.2 CAModule 

A.6.7.4. 2.1 buyEntitlement(org. davic.net. Locator) 

This method is considered to have the amendment. 

Replace: 

Initiates a purchase dialogue for specified service or future event (specified by a Locator). 
With: 

Request to buy a specified service or fiiture event (specified by a Locator) from a conditional access system. 
In the comments of org. davic . net . ca . CAModule .buyEntitlement ( ) the sentence: 

In case of CAO this maps onto event_query with event_cmd_id = mmi (Common Interface specification, section 
B.4.1.1)." 

is replaced with 

In case of DVB Common Interface, this maps onto CI messages as follows: 

• when the Locator points to a service and the terminal is currently receiving the transport stream that this service 
is carried in and this transport stream is available to this CA module, then this method is mapped to a ca_pmt 
message with ca_pmt_cmd_id set to "ok_mmi". The value returned in the ca_pmt_reply is mapped as defined in 
the documentation of the constants in the class. If the module is currently descrambling the service and the 
terminal is aware of this, ENTITLEMENT_AVAILABLE shall be returned immediately without communicating 
with the module. 

• when the Locator points to a service that is not carried in a currently received transport stream, 
NotTunedException is thrown 

• when the Locator points to an event, this maps onto event_query message with event_cmd_id set to "mmi" 
(Common Interface specification, section B.4.1.1). The value returned in the event_reply message is mapped as 
defined in the docmnentation of the constants in this class. 
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In the CA API, the constants defined in the org . davic . net . ca . CAModule class are mapped to the CA_enable 
values of the ca_pmt_response message and the event_status values of the event_reply message in the 
Common Interface protocol as follows: 

ENTITLEMENT_AVAILABLE: 

CA_enable value "Descrambling possible" (0x01) 

event_status value "entitlement_available" (0x01) 

event_status value "mmi_complete_available" (0x05) 
ENTITLEMENT_NOT_AVAILABLE: 

CA_enable value "Descrambling not possible (because no entitlement)" (0x04) 

event_status value "entitlement_not_available" (0x02) 

event_status value "mmi_complete_not_available" (0x06) 
ENTITLEMENT_UNKNOWN: 

CA_enable value "Descrambling not possible (for technical reasons)" (0x05) 

all other CA_enable values not having an explicit mapping in this section 

event_status value "entitlement_unknown" (0x00) 

event_status value "mmi_complete_unknown" (0x04) 

all other event_status values not having an explicit mapping in this section 
MMI_DIALOGUE_REQUIRED: 

CA_enable value "Descrambling possible under conditions (purchase dialogue)" (0x02) 

CA_enable value "Descrambling possible under conditions (technical dialogue)" (0x03) 

event_status value "mmi_dialogue_required" (0x03) 
A.6.7.4.2.2 isDescramblable(ElementaryStream streams[]) 

Is considered to have the following text appended to its description: 

If an empty array is passed in, returns true. 
A.6.7.4.2.3 openMessageSession(MessageListener) 

This method is considered to have the amendment: 

Modify: 

Throws: ModuleBusyException 

raised if the module is busy and is not able to handle a message session at the moment 
To say: 

Throws: ModuleBusyException 

raised if the module is busy and is not able to handle a message session at the moment. This is CA system 
dependant. 

The description of this method is considered to have the following text added to it. 

In systems based on the DVB common interface, messages sessions opened using this method shall be mapped 
onto the CA pipeline for the module represented by this CAModule instance as defined in section 6.8. of the 
common interface extensions specification. Neither the module_id or the resource_id of the module are 
visible to the application. It is the responsibility of the platform to perform the relevant mapping. 

NOTE: The document referred to as "common interface extensions specification." is 
ETSITS 101 699 [71]. 
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The following text: 

Throws : ModuleResourceNonExistentException 

raised if the specified resource cannot be addressed. This includes situations where the resource is not present in 
the module as well as addressing what would be a public resource in a DAVIC CAO / DVB-CI system. 

Is considered to be replaced by: 

Throws: ModuleResourceNonExistentException 

raised if the specified resource is not present in the module. 

NOTE: The ModuleResourceVersionTooLowException shall never be thrown in this version of 
this specification. 

A.6.7.4.2.4 queryEntitlement(org. davic.net. Locator) 

This method is considered to include the following: 

Throws: org. davic.net. InvalidLocatorException 
if the locator does not point to a valid service or event 
In the comments of org . davic . net . ca . CAModule . queryEntitlement ( ) the sentence: 

In case of CAO this maps onto event_query with event_cmd_id = query (Common Interface specification, 
sectionB.4.1.1)." 

is replaced with 

In case of DVB Common Interface, this maps onto CI messages as follows: 

• when the Locator points to a service and the terminal is currently receiving the transport stream that this service 
is carried in and this transport stream is available to this CA module, then this method is mapped to a ca_pmt 
message with ca_pmt_cmd_id set to "query". The value returned in the ca_pmt_reply is mapped as defined in the 
documentation of the constants in the class. If the module is currently descrambling the service and the terminal is 
aware of this, ENTITLEMENT_AVAILABLE shall be returned immediately without communicating with the 
module. 

• when the Locator points to a service that is not carried in a currently received transport stream, 
ENTITLEMENT_UNKNOWN shall be returned. 

• when the Locator points to an event, this maps onto event_query with event_cmd_id = query (Common Interface 
specification, section B.4.1.1). The return values is mapped as defined in the documentation of the constants in 
this class. 

A.6.7.4.2.5 sendToModule 

The description of this method is considered to have the following text added to it. 

In systems based on the DVB common interface, messages sent using this method shall be mapped onto the 
CAPipelineRequest as defined in section 6.8.3 of the common interface extensions specification. Responses from 
the CA system reported through the CAPipelineResponse and CAPipelineNotification messages shall be mapped 
onto instances of ModuleResponseEvent. 

NOTE: The document referred to as "common interface extensions specification." is 
ETSITS 101 699 [71]. 

A.6.7.4.2.6 Protected constructor 

This class is considered to have a no argument protected constructor with the following statement attached to it: 

This constructor is provided for the use of implementations and specifications which extend this specification. 
Applications shall not define sub-classes of this class. Implementations are not required to behave correctly if any 
such application defined sub-classes are used. 
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A.6.7.4.2.7 Additional methods" 

The following specification is considered to contain the following additional methods: 

getApplicationTitle 



/** 

* Retrieves the Application Title String. 

This functionality is provided at low lowel (within MMI and Application Information 
sessions defined in EN50221) by the message application_inf o ( ) message (Application 
Information resource, see 8. 
4.2.2) 

* (^exception ModuleUnavailableException raised if the physical CA module 

* has been removed and is not available any more 

* (^return the application title string 
*/ 

public String getApplicationTitle () throws ModuleUnavailableException; 

enterApplication 

/** 

* Requests the module to enter start the application and enter 

* the main application menu. 

This functionality is provided at low lowel (within MMI and Application Information 
sessions defined in EN50221) by the message enter_menu() message (Application Information 
resource, see 8.4.2.3) 

* (^exception ModuleUnavailableException raised if the physical CA module 

* has been removed and is not available any more 
*/ 

public void enterApplication () throws ModuleUnavailableException; 

closeMMI 

/** 

* Requests the module to leave 

* the complete tree of the current high-level MMI dialogs. 

This functionality is provided at low lowel (within MMI and Application Information 
sessions defined in EN50221) by the message close_mmi() message (MMI resource, see 8.6.2.1) 

* (^exception ModuleUnavailableException raised if the physical CA module 

* has been removed and is not available any more 
*/ 

public void closeMMI () throws ModuleUnavailableException; 

A.6.7.4.2.8 listEntitlements 

This method is considered to have the following text added: 

In case of DVB Common Interface, it is not possible to obtain this information from the CI module. Thus this 
method shall return an array of length zero. 

A.6.7.4.3 CAModuleManager 

A.6.7.4.3.1 addMMIListenerQ 

Is considered to have the following text appended to its description: 

If an application has registered (and not removed) a listener to handle the MMI dialogues and if an MMI dialogue 
is required, this causes the platform to ask the MMI listener to handle the MMI dialogues. If there is no 
application registered to handle the MMI dialogues, these will be handled by the platform. 
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A.6.7.4.3.2 getModules(Services) 

Is considered to have the following text appended to its description: 

If the service passed as a parameter is not scrambled, returns an empty array whose length is 0. 
A. 6. 7. 4. 4 NoFreeCapacityException 

The following class definition is considered to be a normative part of the specification: 

org.davic.net.ca 

NoFreeCapacityException 

Syntax 

public class NoFreeCapacityException extends org . davic . net . ca . CAException 

Java . lang . Ob ject 

-i Java . lang . Throwable 

I 

H Java . lang .Exception 

-\ org ■ davic . net . ca . CAException 

I 

+--org. davic .net . ca. NoFreeCapacityException 

All Implemented Interfaces: 

java.io.Serializable 

Description 

This exception is tiirown wiien a metliod is called and the CA module does not have the required capac- 
ity to perform the action 



Constructors 

NoFreeCapacityExceptionO 

public NoFreeCapacityException ( ) 

Default constructor for the exception 
NoFreeCapacityException(String) 

public NoFreeCapacityException (Java . lang. String reason) 

Constructor for the exception with a specified reason 

Parameters: 

reason - the reason why the exception was raised 

A.6.7.4.5 MMIObject 

The following class definition is considered to be a normative part of the specification: 

org.davic.net.ca 
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MMIObject 

Syntax 

public class MMIObject 
Java . lang . Ob ject 

+ — org.davic.net . ca .MMIObject 

Direct Known Subclasses: 
List, Text 

Description 

The base class of all MMI classes. 



Methods 

closeQ 

public void close () 

Closes the MMI object and informs the CA API implementation that the application intends to close 
or has closed the corresponding MMI screen. 



A.6.7.4.6 DescramblerProxy 

A.6.7.4.6.1 startDescramblingO 

In the comments of org . davic . net . ca . DescramblerProxy . startDescrambling ( ) (all signature 
versions) the sentence: 

This method may start an MMI dialog, 
is replaced with: 

This method may result in the CA system requesting an MMI dialog. 
The description of this method is considered to be extended by the following text: 

In systems based on the DVB common interface this maps onto ca_pmt with ca_pmt_cmd_id = ok_descrambling 
(Common Interface specification, section 8.4.3.4). and the NotAuthorizedException shall never be thrown. 

A.6.7.4.6.2 startDescrambling(org.davic.mpeg. Service, Java. lang. Object) 

Is considered to have the following text appended to its description: 

DescramblerProxy applies from the point of view of one application. Methods such as 
StartDescrambling ( ) and stopDescrambling apply on a per-application basis and do not impact 
descrambling on behalf of other applications, except subject to platform resource limitations. 

A.6.7.4.6. 3 startDescrambling(org.davic.mpeg.ElementaryStream[], Java. lang. Object) 

Is considered to have the following text appended to its description: 
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If org. davic .mpeg. Element arySt ream [ ] is a zero length array the method has no effect. 

A.6.7.4.6.4 startDescrambling(org. davic. mpeg. ElementaryStream[], 

CAModule, Java. lang. Object) 

Is considered to have the following text appended to its description: 

If org. davic .mpeg. Elementary St ream [ ] is a zero length array the method has no effect. 
A.6.7.4.6.5 startDescramblingDialog(org. davic. mpeg. ElementaryStream[]) 

Is considered to have the following text appended to its description: 

If org. davic .mpeg. Elementary St ream [ ] is a zero length array the method has no effect. 
A.6.7.4.6.6 stopDescramblingO 

Is considered to have the following text appended to its description: 

If no descrambling is being done then this method has no effect 
A.6.7.4.6.7 stopDescrambling(org.davic.mpeg.ElementaryStream[] streams) 

Is considered to have the following text appended to its description: 

The method stopDescrambling ( ElementaryStream [ ] ) only stops the descrambling of streams 
which have been started through this DescramblerProxy instance, and not started through any other instance. 

Is considered to include the following parameter specification: 

streams: array of ElementaryStreams whose descrambling is to be stopped. 

Is considered to have the following text appended to its description: 

The StopDescrambling method only affects members of the array of streams that are being descrambled. 
There is no effect on any streams listed in the array that are not being descrambled. 

A.6.7.4.6.8 startDescramblingDIalog 

The description of this method is considered to be extended by the following: 

In systems based on the DVB common interface, the Not Author izedExcept ion shall never be thrown. 
A.6.7.4.6.9 Class Description 

The methods startDescrambling and stopDescrambling in DescramblerProxy are used to add and 
remove, respectively, elementary streams of one service from the set of elementary streams to be descrambled. The MHP 
implementation needs to keep track of the set of elementary streams that are requested to be descrambled by the 
application. 

When the application calls startDescrambling or stopDescrambling and this set of elementary streams 
changes while the service is being descrambled, an implementation using the Common Interface shall send the CA_PMT 
message with the ca_pmt_list_management set to "update" and the version number appropriately changed. This CA_ 
PMT message shall include information about only those elementary streams that are to be descrambled. Those 
elementary streams that are not requested to be descrambled should be omitted from the CA_PMT message completely. 

NOTE 1 : The ca_pmt_cmd_id can't be used to tag elementary streams that should not be descrambled 

because there is no suitable value of ca_pmt_cmd_id for this purpose. Therefore these streams need 
to be left out from the CA_PMT completely. 

NOTE 2: Updating the CA_PMT in response to the method calls from the MHP application requires also 

changing the CA_PMT version_number field. This implies that the MHP implementation needs to 
have an independent version numbering for the CA_PMTs while descrambling one service and the 
version_number field of the PMT in the broadcast can't be simply copied into the CA_PMT. 
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A.6.7.4.7 StartMMIEvent(MMIObject, int, java.lang.Object) 

Is considered to include the following parameter specification: 

caModule: the CAModule object that is the source of the event, which shall be returned by the getSource() method. 

A. 6. 7. 4. 8 ModuleResponseEvent 

A.6.7.4.8.1 Protected Constructor 

This class is considered to have a no argument protected constructor with the following statement attached to it: 

This constructor is provided for the use of implementations and specifications which extend this specification. 
Applications shall not define sub-classes of this class. Implementations are not required to behave correctly if any 
such application defined sub-classes are used. 

A.6.7.4.9 NewModuleEvent 

The class description for this class is considered to have the following text appended to it: 

In the case of a C A module based on the DVB common interface, this event shall only be generated when module 
initialisation has been completed. Hence an application has no means to detect when a module is inserted but has 
not yet been initialised. 

A.6.7.4.10 PIDChangeEvent 

The following the text: 

This event is generated as part of the Host Control functionality in the Common Interface / CAO to signal that an 
elementary stream should be substituted with an other one. This event is intended for data services only. 
Television services that are presented using a high level media player API (whose implementation implicitly 
handles descrambling) will also have this event handled implicitly by that implementation. 

Is considered to be replaced with the following: 

In systems based upon the DVB Common Interface this event is generated in response to the Host Control replace 

/ clear_replace requests. 

NOTE: This event is for information only. The platform is responsible for implementing the requests from 
the CA system. See also R206 [79]. 

This class is considered to inherit from org . davic . net . ca . CAEvent instead of org . davic . net . ca . 
DescramblerEvent. 

The text: 

public PIDChangeEvent (short oldPid, 
short newPid, 
Object descramblerProxy) 

and: 

descramblerProxy - the DescramblerProxy object representing the descrambling resource which is the source of 
the event. 

is considered to be replaced with: 

public PIDChangeEvent (short oldPid, 
short newPid, 
Object caModule) 

and: 

caModule - the CAModule object representing the CA system which is the source of the event. 
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The text: 

public Object getSourceO 

Returns the DescramberProxy that is the source of the event. 
Overrides: 

getSource in class DescramblerEvent 
is considered to be replaced with: 

public Object getSource () 

Returns the C AModule that is the source of the event. 

Overrides: 

getSource in class CAEvent 

A.6.7.4.11 TuneRequestEvent 

The following text: 

This event is generated as part of the Host Control functionality in the Common Interface / CAO. 
Is considered to be replaced with the following: 

In systems based upon the DVB Common Interface this event is generated in response to the Host Control tune 
request. 

NOTE 1 : This event is only guaranteed to be delivered to applications that survive the service selection 
caused by the Host Control tune request (see 1 1 .6.4, "Conditional Access API" on page 130). 

NOTE 2: This event is for information only. The platform is responsible for implementing the service 
selection autonomously in response to the request from the CA system. 

This class is considered to inherit from org . davic . net . ca . CAEvent instead of org . davic . net . ca . 
DescramblerEvent. 

The text: 

public TuneRequestEvent (Locator locator, 

Object descramblerProxy) 

and: 

descramblerProxy - the DescramblerProxy object representing descrambler resource which is the source of the 
event 

is considered to be replaced with: 

public TuneRequestEvent (Locator locator, 
Object caModule) 

and: 

caModule - the C AModule object representing the CA system which is the source of the event. 
The text: 

public Object getSource () 

Returns the DescramberProxy that is the source of the event. 

Overrides: 

getSource in class DescramblerEvent 
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is considered to be replaced with: 

public Object getSourceO 

Returns the CAModule that is the source of the event. 

Overrides: 

getSource in class CAEvent 

A.6.7.4.12 DescramblingStarted Event 

In the case of DVB common interface, this event is sent when the MHP terminal has requested the module to start the 
descrambling. 

A.6.7.4.13 DescramblingStopped Event 

In the case of DVB common interface, this event is sent when the MHP terminal has requested the module to stop the 
descrambling. 

A.6.7.5 dvb.DvbLocator(int onid, int tsid, int serviceid, int eventid, 

int componenttags[], String filePath). 

The following parameter specification: 

the: file path string including the slash character in the beginning 
is considered to read: 

filePath: string including the slash character in the beginning 

A.6.7.6 dvb.DvbLocator 

A.6. 7.6.1 DvbLocator(int, int, int, int, int[]) 

In the constructor DvbLocat or (int, int, int, int, int []), the name of the last parameter in the method 
signature shall be considered to be "component tags". 

A.6.7.6.2 Additional metinod 

The following method is considered to be present: 

/** Returns the textual service identifier, if one was provided to the constructor. 

* @return the textual service identifier, null if not present 

* @since MHPl.0.1 
*/ 

public String getTextualServiceldentif ier ( ) ; 

A.6. 7.6.3 getOriginalNetworl<ld 

The returns clause of the getOriginalNetworkId ( ) method is considered to include "-1 if not present" similarly 
as the other methods returning the numeric identifiers. 

A.6.8 org.davic.net.tuning 
A.6.8.1 Figure H-1 

In Figure H-1: " Tuning API object model: Base classes. " in the class Networklnterf ace, the method getURL ( ) 
shall be considered to be "getLocator ( ) " 
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A.6.8.2 Figure H-2 

In: 

Figure H-2: " Tuning API object model: Exceptions." 
the exception IncorrectURLException shall be considered to be absent. 

A.6.9 Extensibility and Over-Riding 

The DAVIC specification DAVIC 1.4.1p9 [3] is considered to include the following; 

The addition of public or protected constructors, methods or fields to the org . davic packages is allowed except 
where this would cause a compliant MHP application to fail. Examples of the latter include the adding of abstract 
methods to classes or adding of methods to interfaces which application classes will implement. 

Within the o r g . davi c package and its sub packages, overriding inherited public and protected methods not 
specified as being overridden is an allowable implementation option. 

NOTE: This language does not apply to constructors or to fields, because inherited fields and constructors cannot 
be overridden in the Java language. 



A.7 HAVi [50] 

A.7.1 Drafting conventions 



This specification does not follow the ETSI drafting rules as specified in ETSI TR 101 262 [81]. In particular, the term 
"should" shall be interpreted in terms of the ETSI drafting rules as being closer to "shall" than "should". 

A.7.2 General 
A.7.2.1 Thread-safety 

As with the j ava . awt package, the org . havi . ui package is not required to be thread safe. 

A.7.2.2 javadoc errors 

The javadoc for the HAVi specification appears to be compiled against a version of the "Java.*" packages more recent 
than that required for the MHP specification. All methods, fields & inner classes shown as inherited from classes outside 
the "org. havi" package namespace which are not present in the MHP specification for that class shall be considered to be 
absent from the HAVi specification. 

A.7. 3 Event mechanism 

This section presents a clarification for the HAVi event mechanism. 

A.7. 3.1 Introduction 

One of the reasons for the HAVi event mechanism is to provide a mechanism for widgets to request a type of input that 
may not be available on the input device supported by a platform. A HAVi widget can indicate its input preference by 
implementing one or more HxxxInputPref erred interfaces. This is important to enable application provided 
widgets to have access to the same capabilities as have always been available to platform provided ones. 

An HxxxInputPref erred interface indicates the widget that implements the interface expects a certain type of input 
events. E.g. on systems with limited input devices the platform can supply a virtual keyboard to generate the interface- 
specific events. 

The Hxxxable and HxxxValue interfaces group methods common to various HVisible subclasses; they do not 
imply additional support from the platform. 
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The HxxxInputPref erred interfaces all imply possible support by a (virtual) keyboard. The platform shall provide 
a way for the user to generate the input expected by the focused component. This could mean automatically presenting 
some kind of virtual keyboard when a focused component requires input that could not be generated in another way. The 
platform can determine which virtual keys a widget requires by looking at the HxxxInputPref erred interfaces it 
implements. 

For keyCode input, HNavigationlnputPref erred. getNavigationkeys ( ) and 
HKeyboardlnputPref erred. getValidlnput () allow the platform to determine which keyCodes the 
particular widgets expect. Platform implementations shall provide the user with a means to generate the keyCodes 
expected by all HxxxInputPref erred interfaces implemented by the widget having input focus (with the exception 
of keyCodes not supported according to org.havi .ui .event . HKeyCapabilities). 

HAVi events generated by the platform and sent to a HComponent are HActionEvent, HAdjustmentEvent, 
HItemEvent, HTextEvent, HRcEvent, HFocusEvent and HKeyEvent. 

A.7.3.2 Overview of HAVi events 

HComponent s indicate they want to receive HFocusEvent s by implementing the 

HNavigationlnputPref erred interface. For HNavigationlnputPref erred, the keyCodes for 
navigation keystrokes generated on the HNavigationlnputPref erred will be passed to the 
HNavigationlnputPref erred as an HFocusEvent transf erid. The HNavigationlnputPref erred 
will process an HFocusEvent of id FOCUS_TRANSFER in its processHFocusEvent method by calling 
requestFocus on the HNavigable associated with the keyCode returned by HFocusEvent . 
getTransferld ( ) , if there is one. 

Implementations of HNavigationlnputPref erred will not send this HFocusEvent to FocusListeners or 
HFocusLi stener s, it is only used by the platform to communicate the transferld to the 

HNavigationlnputPref erred. 

The manner in which the keystrokes are generated is implementation-specific, as some platforms may supply a more 
extensive hardware keyboard, while other platforms may choose to provide a virtual keyboard to generate these 
keystrokes. 

Also, HAVi allows generation of the HAVi events on top of AWT (in HComponent . processEvent) from other 
events as an implementation option, to allow for platforms unable to generate HAVi event directly. As a result of this, it is 
platform specific whether processEvent is ever called with a HAVi event as argument, or that the event is generated 
in this method from other events. In such an implementation, a widget may receive the original, unexpected, platform- 
specific, non-HAVi j ava . awt events as well as the translated HAVi events. To avoid confusion, a HAVi widget is 
supposed to process only the HAVi events and applications should ignore other events (i.e. not add listeners for java . 
awt events and not use them through processXxxEvent methods). 

For the handling of navigation keys, an implementation of the HNavigationlnputPref erred interface receives 
the keycodes for navigation as the transferld of org . havi . ui . event . HFocusEvent, and not as a j ava . awt . 
event . KeyEvent or org . havi . ui . event . HKeyEvent . (On platforms which generate HAVi events from 
other events, it is possible that the component does receive a j ava . awt . event . KeyEvent, however this is 
platform-specific and applications should not rely on this). 

Hcomponent . processEvent is responsible to dispatch HFocusEvents to the processHFocusEvent 
method; this method will call requestFocus on the target of a transferld for a FOCUS_TRANSFER event, and 
send HFocusEvents of type FOCUS_GAINED and FOCUS_LOST to any registered HFocusListeners for classes 
that support adding these listeners. Depending on which other HAVi interfaces the component implements and on 
whether it extends HVisible, this method will also change the state of the widget, play appropriate sounds, and notify 
any listeners specified in these other interfaces for a focus change. 

An HComponent implementing HKeyboardlnputP referred will receive input in the form of HKeyEvent s. On 
platforms with limited input devices, the platform can present a virtual keyboard for the user to generate the requested 
keyCodes. The platform can use the input type of the HKeyboardlnputPref erred to determine which keys to 
present on this virtual keyboard, however, the platform is not required to prevent the user from generating more 
keyCodes than those requested by the HKeyboardlnputPref erred. 

HAVi allows to generate the HKeyEvents from other events in HComponent .processEvent, so any 
KeyEvent s received by the component which are not HKeyEvents should be ignored as platform-specific. 
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Hcomponent .processEvent is responsible for dispatching HKeyEvents to the processHKeyEvent method; 
this method will send the HKeyEvent to any registered HKeyListeners for classes that support adding these 
listeners. 

If an HComponent implements both HNavigationlnputPref erred and HKeyboardlnputPref erred, the 
platform will provide a way for the user to generate the keyCodes for both HFocusEvents and HKeyEvents in an 
unambiguous way (e.g. while in edit mode, keyCodes are converted into HKeyEvents, otherwise they generate 
HFocusEvent s). The getEditMode method can be called by the platform to determine the current input mode of 
the widget. The platform will provide a platform specific way to switch between any different input modes as required by 
any limitations of its input devices, and notify the widget of this change by sending it an appropriate START_CHANGE or 
END_CHANGE event. 

If the same keyCode is expected for different input types (e.g. VK_ENTER is set as navigation code while the widget 
also expects it as an HKeyEvent), then the platform will present the user with means to separately generate each of the 
HAVi events for that key Code (in the case of the example, an HFocusEvent with transferld VK_ENTER and an 
HKeyEvent). Application authors should realize that to use keyCodes which are likely to have multiple functions 
may force some platforms to present a less than perfectly user-friendly display. 

For platforms that generate HAVi events in HComponent .processEvent, extra events maybe received in addition 
to the HAVi events. For example, for HFocusEvent FOCUS_GAINED and FOCUS_LOST, if the HFocusEvent is 
generated directly, processEvent should send this HFocusEvent to bothprocessHFocusEvent and to 
processFocusEvent (the second one will happen in the superclass method). If the platform generates HAVi events 
in processEvent, when a Focus Event is received by HComponent .processEvent, it will be sent to 
processFocusEvent and a new HFocusEvent will be created to send to processHFocusEvent. 

For the other HAVi events, like HActionEvent, HAdjustmentEvent, HItemEvent and HTextEvent events, 
the behaviour is analogous. The platform will provide a way for the user to generate the events, either directly or from 
other events (translated in HComponent . processEvent), on HComponents that implement the 

HActionlnputPref erred, HAdjustmentlnputPref erred, HSelectionlnputPref erred, and 
HKeyboardlnputPref erred interfaces, respectively. 

Implementations of the interfaces do not have to override processEvent so as to send these events to the appropriate 
processHxxEvent method, this will be the responsibility of Hcomponent .processEvent. The 
proce s sHxxEvent method will call any registered listeners and perform any other specified actions, such as changing 
states, playing sounds, etc. 

HAdjustmentlnputPref erred and HSelectionlnputPref erred, which extend HOr lent able, allow the 
platform to select a way for the user to generate HAd justmentEvents and HItemEvents which best matches the 
component's representation. 

A.7.3.3 Relation between HAVi events and AWT events 

Applications which extend from Java . awt . Component (and not org . havi . ui . HComponent) and which 
register event listeners from the Java . awt . event package shall receive the behaviour defined for the Java . awt . 
event package. If events from the org . havi . ui . event package are generated on such a Component, these shall 
be sent to any registered listeners according to the behaviour defined for their parent class in j ava . awt . event . 

HAVi allows implementations that generate HxxxEvents from other events, so an HComponent may receive the 
HxxxEvent in addition to those other events. For example, you could get both havi .ui .event .HKeyEvents sent 
to HKeyListeners and awt .event .KeyEvents sent to AWT KeyListeners. 

For subclasses that extend from Component and not from HComponent, it is implementation dependent whether they 
receive the events defined in awt . event or a subclass of these events defined in havi (e.g. org . havi . ui . event . 
HKeyEvent instead of Java . awt . event . KeyEvent). However, in the latter case the behaviour will be as defined 
for the parent class, e.g. an org. havi .ui . event . HKeyEvent will go to KeyListeners added with 
Component . addKeyListener. Also, applications cannot assume that such Components will be able to receive 
KeyEvent s with keyCodes other than those specified in the MHP minimum profile. 
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A.7.3.4 Application guidelines 

Any implementation of a HxxxInputPref erred interface shall implement the processing of the HxxxEvent and 
calling of listeners in the processHxxEvent method (where this event processing is not inherited from a parent 
class). It is the platforms' responsibility to provide a way in which the user can generate the events requested by the 
widget. Since the HAVi events may be generated in the processEvent method on some platforms, interface 
implementers should not assume that the processEvent method will receive the HAVi events on every platform. On 
platforms where the HAVi events are generated in processEvent, it is the platform's responsibility to call the 
processHxxEvent method with the HAVi event. 

A.7.4 org.havi.ui 
A.7.4.1 HActionable 

The class HListGroup is considered to be removed from the list of "Platform Classes". 

A.7.4. 1.1 getActionSound 

The description of this method shall be considered to be replaced with the following 

Return the last action sound set by the setActionSound method or null if no action sound has been set. 

A.7.4.2 HActionlnputPreferred 

The description of this method shall be considered to have the following text added: 

If this HActionlnputPreferred has no action command then an empty string shall be returned. 

A.7.4. 3 HAdjustmentlnputPreferred 

A. 7. 4. 3.1 Interface description 

In the interface description of HAdjustmentlnputPreferred after the sentence: 

For platforms with a restricted number of physical keys this may involve a "virtual keyboard" or similar 
mechanism. 

is considered to be extended by the following text: 

The system might use the information returned by the method getOrientation () of the super interface to 
select appropriate key mappings for this event. The mechanisms to generate this event shall not be effective while 
the component is disabled (see HComponent . setEnabled ( ) ). 

Also, the following text: 

All interoperable implementations of the HAdjustmentlnputPreferred interface must extend 

HComponent. 

Is considered to be replaced with: 

Widgets of HAVi compliant applications implementing the HAdjustmentlnputPreferred interface must 
have HComponent in their inheritance tree. 

Also, in the following text: 

Note that the Java . awt . Component method isFocusTraver sable should always return true for a 
Java . awt . Component implementing this interface. 

the word "should" is considered to be replaced with "shall". 

A.7.4. 3.2 getAdjustMode 

The last sentence of the description of getAdjustMode ( ) is considered to be extended with: 

Note that these events are ignored, if the component is disabled. See also: HComponent . setEnabled ( ) . 
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A. 7. 4. 3. 3 proccessHAdjustmentEvent 

The description of proccessHAdjustmentEvent ( ) is considered to be extended with: 

Widgets implementing this interface shall ignore HAdjustmentEvents, while the component is disabled. See 
also: HComponent . setEnabled ( ) . 

A.7.4.3.4 setAdjustMode 

The description of setAdjustMode ( ) is considered to be extended with: 

Calls to this method shall be ignored, if the component is disabled. See also: HComponent . setEnabled ( ) . 

A.7.4.4 HAdjustmentValue 

A. 7. 4. 4.1 Class description 

The class HListGroup is considered to be removed from the list of "Platform Classes". 

A.7.4.4.2 getAdjustmentSound 

This method is considered to have the following text added to the method description. 

null shall be returned if this method is called before its corresponding set method. 
A.7.4.4. 3 getBlocl<lncrement 

This method is considered to have the following text added to the method description. 

1 shall be returned if this method is called before its corresponding set method. 
A.7.4.4.4 getUnitlncrement 

This method is considered to have the following text added to the method description. 

1 shall be returned if this method is called before its corresponding set method. 

A.7.4.5 HAnimateEffect 

A.7.4.5.1 getRepeatCount 

This method shall be considered to have the following text added to the method description. 

Except for HAnimateEffect implementations that specify a different default, getRepeatCount ( ) returns 
REPEAT_INFINITE if no call to setRepeatCount ( ) has previously been made. 

A.7.4.6 H Background Device 

A. 7. 4. 6.1 setBacl<groundConfiguration 

In the setBackgroundConf iguration method, the sentence below shall be considered to be added to the 
description of this method: 

Applications can prevent or limit changes to configurations of other, not intended, devices by using constants 
ZERO_GRAPHICS_IMPACT, ZERO_VIDEO_IMPACT and ZERO_BACKGROUND_IMPACT in their 
configuration templates. 

The following shall be added as the first item in the buUeted list: 

• If an application tries to select a configuration which is not valid for that device at that time or when the device is 
in a particular mode then an HConfigurationException shall be thrown. 

A. 7. 4. 6. 2 getConfigurations 

The following shall be added to the end of the method description. 

The set of configurations returned may include ones which are only valid for the device at particular times or 
when the device is in a particular mode. 
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A.7.4.7 H Background I mage 

A. 7. 4. 7.1 Constructors - HBackgroundlmage(String), HBackgroundlmage(URL) 

The sentence: 

Loading of the data for the object is not required at this time, 
shall be considered to be replaced with: 

Loading of the data for the object shall not happen at this time. 

A.7.4.7.2 load 

The following text is considered to be added to the description of this method: 

Multiple calls to load shall each add an extra listener, all of which are informed when the loading is completed. If 
load is called with the same listener more than once, the listener shall then receive multiple copies of a single 
event. 

A.7.4.7.3 Constructor(byte[]) 

In the following sentence: 

If the byte array does not contain a valid image then this constructor shall throw a java.lang. 
IllegalArgumentException. 

"shall" shall be considered to say "may". 

A.7.4.8 HComponent 

A. 7. 4. 8.1 processEvent 

The following text is a clarification of the HAVi specification: 

The implementation of the method HComponent . processEvent ( ) shall ensure that key events which are 
translated to HAVi events shall not be reported to processKeyEvent ( ) or reported to KeyListeners. Key events 
which are not translated to HAVi events shall be reported to processKeyEvent ( ) and KeyListeners as defined 
in the Java specification. 

NOTE: If applications override processEvent they may terminally disturb these processes. 

Applications should not do this without extreme care, as the results may be very implementation 
dependent. 

A.7.4.9 HComponentOrdering 

A.7.4.9.1 addAfter, addBefore 

In the returns clause, the text: 

is successfully added, 
shall be considered to read 

is successfully added or was already present. 

A.7.4.10 HEventMulticaster 

A. 7. 4. 10.1 Class description 

The following text is considered to be added to the description of this class: 

The HEventMulticaster class is intended to assist platform or subclass implementers with the handling of 
HAVi events. Implementations are not required to use this class to dispatch HAVi events. Applications should not 
extend the HEventMulticaster class and implementations are not required to behave correctly if an 
application does extend this class. If an extended multicaster is desired, AWTEventMulticaster should be 
used rather than HEventMulticaster. 
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Also, extend the following paragraph in the class description: 

It is an implementation option for this class to insert other classes in the inheritance tree (for example j ava . 
awt .AWTEventMulti caster). It is allowed that this may result in HEventMulticaster inheriting 
additional methods beyond those specified here. 

with: 

If this class does extend Java . awt . AWTEventMulticaster, it is allowed for the fields defined in this class 
to be inherited from that parent class. 

A.7.4.10.2 Constructor 

The following text is considered to form part of the constructor description: 

The parameters a & b passed to the constructor shall be used to populate the fields a & b of the instance. 
A.7.4.10.3 remove 

In the description of this method, replace: 

returns the resulting multicast listener 
with 

returns the result 

A.7.4.11 HFontCapabilities 

A.7.4.11 .1 getSupportedCharacterRanges 

The returns clause of this method shall be considered to be extended with the following text: 
including where the capabilities of the font are unknown. 

A.7.4.12 HGraphicsDevice 

A.7.4.12.1 getBestConfiguration 

The following text shall be considered to be added to the end of the second paragraph of the method description: 

If there are such equally best configurations, the one which is returned by this method is an implementation 
dependent selection from among those which are equally best. 

A.7.4.12.2 setGraphicsConfiguration 

In the setGraphicsConfiguration method, the sentence below: 

Applications can prevent or limit changes to configurations of other, not intended, devices by using constants 
ZERO_GRAPHICS_IMPACT and ZERO_VIDEO_IMPACT in their configuration templates. 

shall be considered to be extended as follows: 

Applications can prevent or limit changes to configurations of other, not intended, devices by using constants 

ZERO_GRAPHICS_IMPACT, ZERO_VIDEO_IMPACT and ZERO_BACKGROUND_IMPACT in their 
configuration templates. 

The following shall be added as the first item in the bulleted list; 

• If an application tries to select a configuration which is not valid for that device at that time or when the device is 
in a particular mode then an HConfigurationException shall be thrown. 

A.7.4.12.3 getConfigurations 

The following shall be added to the end of the method description. 

The set of configurations returned may include ones which are only valid for the device at particular times or 
when the device is in a particular mode. 
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A.7.4.13 HGraphicsConfigTemplate 

A.7.4.13.1 setPreference 

The following text shall be added to the third paragraph of the method description: 

Calling this method with null for the object parameter shall have no effect if the preference is not currently set in 
the template. 

A.7.4.14 HListElement 

A. 7. 4. 14.1 Class description 

The class description is considered to be extended by the following: 

The methods setlcon () and setLabel () of HListElement shall not be used for elements, which are part 
of HListGroup. If an application requires to alter the content, it shall either replace the entire element, or 
remove it temporarily and re-add it after the content was changed. 

A.7.4.15 HListGroup 

A.7.4.15.1 Class description 

In the following text: 

The HListGroup is a user interface component representing a list of selectable items (HListElements) 
which contain static read-only graphical and / or textual content. 

The phrase "static read-only" is considered to be removed. 

Also, extend the following text: 

Interoperable HAVi applications shall not add HListElement more than once. If an application requires items 
with identical contents (label and/or icon), then additional items shall be created. The behaviour of the 
HListGroup if duphcates are added is implementation specific. 



With: 



The methods setlcon () and setLabel () of HListElement shall not be used for elements, which are part 
of HListGroup. If an application requires to alter the content, it shall either replace the entire element, or 
remove it temporarily and re-add it after the content was changed. 

Also, in the text: 

the minimum size is the size to present one element or an implementation specific minimum (32 x 32 for 
example) if no elements are present. 

The phrase "if no elements are present" is considered to be replaced with: 

if label and icon size are not set (see HListGroupLook . getMinimumSize ( ) ). 

Also, under the parameters table under heading "Default parameter values exposed in the constructors" the description of 
the parameter "items" missing is considered to read: 

The initial list of elements for this HListGroup or null for an empty list. 

A.7.4.15.2 Fields 

A.7.4. 15.2.1 ITEM_NOT_FOUND 

In the description: 

A constant which may be returned from get Index if the requested element is not found in the content. 
The word "may" is considered to be replaced by "shall". 
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A.7.4. 15.2.2 ADD_INDEX_END 

In the description: 

A constant for use with addltem and addltems which specifies that the new items should be appended to the 
end of the list. 

The word "should" is considered to be replaced by "shall". 
A.7.4.15.3 Use of "action" and "actioning" 

The use of the words "action" and "actioning" in the following methods in HListGroup does not imply any connection 
between HListGroup and HActionable. There is no such connection in the API.: 

• getCurrentlndex ( ) 

• getCurrentltem ( ) 

• setCurrentltem ( ) 

• getSelectionlndices ( ) 

• getSelection ( ) 

A.7.4. 15.4 addltem(HListltem item, int index) 

In the description of parameter "index" all occurrences of the word "items" is considered to be replaced by "item". 

A. 7. 4. 15. 5 addltem(HListltem items[], int index) 

In the parameter description: 

item - the item to add. 
is considered to be replaced by: 

items - the items to add. 

A.7.4. 15. 6 getlconSize 

The description of this method is considered to be extended by: 

If label and icon size do not match the size per element, the associated HListGroupLook is allowed to use 
other sizes during the rendering process. This size shall be used by HListGroupLook to calculate the size per 
element. 

A.7.4.15.7 getLabelSize 

The description of this method is considered to be extended by: 

If label and icon size do not match the size per element, the associated HListGroupLook is allowed to use 
other sizes during the rendering process. This size shall be used by HListGroupLook to calculate the size per 
element. 

A.7.4. 15.8 getOrientation 

The following text: 

The orientation controls how an associated HLook lays out the component and affects the visual behaviour of the 

HAdjustmentEvent and HItemEvent events. HListGroups do not receive HAdjustmentEvents. 

Is considered to be replaced by: 

The orientation controls how an associated HLook lays out the component and affects the visual behaviour of 
HItemEvent events. 
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A.7.4.15.9 setFocusTraversal 

In all cases the phrase "then null should be specified" is considered to be replaced by "then null shall be specified". 

A.7.4.15.10 setltemSelected 

The following text 

If a successful call to this method causes the selection to change an HItemEvent shall be sent to any registered 
listeners. If the selection does not change then no HItemEvent shall be sent. 

Shall be considered be replaced with: 

If a call to this method causes an item to become deselected an HItemEvent with an ID of ITEM_CLEARED shall 
be sent to all registered listeners. This can happen because either sel is false or this HListGroup is not in multi 
selection mode. 

If a call to this method causes an non selected item to become selected item then an HItemEvent with an ID of 
ITEM_SELECTED shall be sent to all registered listeners. 

A.7.4.15.11 setlconSize 

The description of this method is considered to be extended by: 

If label and icon size do not match the size per element, the associated HListGroupLook is allowed to use 
other sizes during the rendering process. This size shall be used by HListGroupLook to calculate the size per 
element. 

In the description of the size parameter, the following text: 

Dimension(DEFAULT_ICON_SIZE,DEFAULT_ICON_SIZE) 
is considered to be replaced by 

Dimension(DEFAULT_ICON_WIDTH,DEFAULT_ICON_HEIGHT) 

A.7.4.15.12 setLabelSize 

The description of this method is considered to be extended by: 

If label and icon size do not match the size per element, the associated HListGroupLook is allowed to use 
other sizes during the rendering process. This size shall be used by HListGroupLook to calculate the size per 
element. 

A.7.4.15.13 setListContent 

The sentence: 

Any existing selection is discarded (which may cause an HItemEvent to be generated.) 

Is considered to be replaced by 

If any elements are selected, then the selection is discarded and an HItemEvent is generated. 
The following text: 

Set the list content for this HListGroup. If any elements are selected, then the selection is discarded and an 
HItemEvent is generated. 

Shall be considered to be replaced with: 

Set the list content for this HListGroup. If any items are selected, then the selection shall be discarded and an 
HItemEvent with an ID of ITEM_SELECTION_CLEARED shall be generated and sent to all registered listeners. 

If elements is null then the current active item index shall be set to ITEM_NOT_FOUND. If elements is non null 
then the current active item index shall be set to 0. An HItemEvent with an ID of ITEM_SET_CURRENT shall be 
sent to all registered listeners. 
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A.7.4.15.14 setMove 

In all cases the phrase "then null should be specified" is considered to be replaced by "then null shall be specified". 

A.7.4.15.15 setScrollPosition 

This method is considered to have the following text added: 

Parameters 

scroll - the scroll position 

A.7.4.15.16 setSelectionMode 

The parameter in the method signature called adjust shall be considered to be called edit as used in the parameter 
list. 

A.7.4.15.17 removeltem 

The following text: 

Remove the HListElement at the specified index. The item is also removed from the selection, if any is set. If this 
was the last item in the selection the entire selection is destroyed and calls to getSelection shall return null until 
new content and selections are created. 

If the act of removing an item causes the current active item index to change, an HItemEvent shall be sent. 

If the act of removing an item causes the selection to change, an HItemEvent shall be sent. 

Shall be considered to be replaced with the following text: 

Removes the HListElement at the specified index. All following items are shifted. 

If the item is the only HListElement in this HListGroup then the current active item index shall be set to ITEM_ 
NOT_FOUND. If the removal of the item causes a change in the current active item index then an HItemEvent 
with an ID of ITEM_SET_CURRENT shall be generated and sent to all registered listeners. 

If the item is selected then it shall be removed from the selection and an HItemEvent with an ID of ITEM_ 
CLEARED shall be generated and sent to all registered listeners. 

A.7.4.15.18 removeAlltems 

The following text: 

Remove all the content. The selection is also destroyed and calls to getSelection shall return null until new content 
and selections are created. 

Shall be considered to be replaced with: 

Removes all the content. If any items are selected, then the selection shall be discarded and an HItemEvent with 
an ID of ITEM_SELECTION_CLEARED shall be generated and sent to all registered listeners. 

The current active item index shall be set to ITEM_NOT_FOUND and an HItemEvent with an ID of ITEM_SET_ 
CURRENT shall be generated and sent to all registered listeners. 

A.7.4.15.19 setCurrentltem 

The following paragraph shall be considered to form part of the description of this method. 

If index is valid for this HListGroup then the current active item index shall be set to index. If this causes a change 
in the current active item index then an HItemEvent with an ID of ITEM_SET_CURRENT shall be generated and 
sent to all registered listeners. 

Under the Returns subsection, the following paragraph; 

true if the current item was changed, false if index was not a valid index for this HListGroup or the current item 
was not changed because it is already selected. No exception is thrown if index is not valid. 
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Shall be considered to be replaced with: 

true if the current item was changed, false if index was not a valid index for this HListGroup or the current item 
was not changed because it is already the current item. No exception is thrown if index is not valid. 

A.7.4. 15.20 setMultiSelection 

The following text: 

Note that if the HListGroup is switched out of multiple selection mode and more than one item is selected, the 
selection shall change so that the first of the items is selected and the others are deselected. This will cause an 
HItemEvent to be sent to any registered listeners. 

Shall be considered to be replaced with: 

Note that if the HListGroup is switched out of multiple selection mode and more than one item is selected, the 
selection shall change so that the first of the items is selected and the others are deselected. An HItemEvent with 
an ID of ITEM_CLEARED shall be sent to all registered listeners for each deselected item. 

A.7.4.16 HListGroupLook 
A.7.4. 16.1 getMaximumSize 

The description of getMaximumSize ( ) is considered to be replaced by the following: 

Returns the size to present all elements of the specified HVisible plus any additional dimensions that the 
HListGroupLook requires for border decoration etc. If no elements are present, a dimension object is returned 
with width and height set to j ava . lang . Short . MAX_VALUE. 

The extra space required for border decoration can be determined from the get Inset s ( ) and 
getElementlnsets ( ) methods. The behaviour is not defined for the case, when a subclass overrides these 
methods. Application developers shall not assume any influence on the returned dimensions. 

The size per element shall be determined by calls to getlconSize ( ) and getLabelSize ( ) of 
HListGroup. If any of the values requests a defauh as specified by DEFAULT_IC0N_WIDTH, DEFAULT_ 
ICON_HEIGHT, DEFAULT_LABEL_WIDTH and DEFAULT_LABEL_HEIGHT, then an implementation 
specific default is used for the corresponding value(s). 

Parameters: 

visible HVisible to which this HLook is attached. 
Returns: 

A dimension object indicating this HListGroupLook ' s maximum size. See also: 

HListGroup. setlconSize () 
HListGroup. setLabelSize ( ) 
HVisible . getMaximumSize ( ) 

A.7.4. 16.2 getMinimumSize 

The description of getMinimumSize ( ) is considered to be replaced by the following: 

Returns the size to present one element of the specified HVisible plus any additional dimensions that the 
HListGroupLook requires for border decoration etc. 

The extra space required for border decoration can be determined from the get Inset s ( ) and 
getElement Inset s ( ) methods. The behaviour is not defined for the case, when a subclass overrides these 
methods. Application developers shall not assume any influence on the returned dimensions. 

The size per element shall be determined by calls to getlconSize ( ) and getLabelSize ( ) of 
HListGroup. If any of the dimensions requests a default as specified by DEFAULT_IC0N_WIDTH, 
DEFAULT_ICON_HEIGHT, DEFAULT_LABEL_WIDTH and DEFAULT_LABEL_HEIGHT, then an 
implementation specific default is used for the corresponding value(s). 

Parameters: 

visible HVisible to which this HLook is attached. 
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Returns: 

A dimension object indicating this HListGroupLook ' s minimum size. See also: 

HList Group. setlconSize () 
HLi St Group . setLabelSize ( ) 
HVisible . getMinimumSize ( ) 

A.7.4.16.3 getPreferredSize 

The description of getPreferredSize ( ) is considered to be replaced by the following: 

Gets the preferred size of the HVisible component when drawn with this HListGroupLook. 

If a default size for width and height was set with HVisible. setDefaultSize (), then the dimensions are 
rounded down to the nearest element (minimum of one) according to the orientation of the associated 
HLi stGroup, and any dimensions for border decorations etc. are added. 

If no default size was set or only for one dimension (i.e. height is NO_DEFAULT_HEIGHT or width is N0_ 
DEFAULT_WIDTH), then the unset dimension(s) shall be sufficiently large to present five elements according to 
the HListGroup ' s orientation. Any dimensions for border decoration etc. are added. 

The extra space required for border decoration can be determined from the get Inset s ( ) and 
getElement Inset s ( ) methods. The behaviour is not defined for the case, when a subclass overrides these 
methods. Application developers shall not assume any influence on the returned dimensions. 

The size per element shall be determined by calls to getIconSize() and getLabelSize() of HListGroup. If any of the 
values requests a defauh as specified by DEFAULT_ICON_WIDTH, DEFAULT_ICON_HEIGHT, DEFAULT_ 
LABEL_WIDTH and DEFAULT_LABEL_HEIGHT, then an implementation specific defauh is used for the 
corresponding value(s). 

Parameters: 

visible HVisible to which this HListGroupLook is attached. 

Returns: 

A dimension object indicating the preferred size of the HVisible when drawn with this 
HListGroupLook. See also: 

HListGroup . setlconSize () 
HListGroup. setLabelSize ( ) 
HVisible . getPreferredSize ( ) 

HVisible. setDefaultSize () 

A.7.4.16.4 getValue 

The first paragraph of getValue ( ) is considered to be extended by the following: 

A non-null value represents the scroll position of the associated HLi stGroup. The value shall never be less than 
zero. 

And the description of returns is considered to be replaced by the following: 

the non-negative scroll position associated with the specified pointer position or null 
A.7.4.16.5 hitlest 

In the description of hitlest () after 

. . .then this method will return the index of that element. 
is considered to be extended by the following: 

The HLi StGroup shall interpret this index as current item. If the value is AD JUST_THUMB, then the caller shall 
use getValue ( ) to retrieve the actual scroll position corresponding to the specified pointer position." 

And the returns description considered to be extended by the following: 
, or a non-negative element index. 
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A.7.4.16.6 showLook 

The description of showLook ( ) is considered to be replaced by the following: 

This method is responsible for repainting the entire visible including the list content set on the HListGroup, 
and the visible background, subject to the clipping rectangle of the graphics object passed to it. 

If the method modifies the clipping rectangle of the graphics object, it shall restore the original rectangle upon 
return. 

showLook ( ) paints the visible with its current background colour according to the getBackgroundMode ( ) 
method of HVisible and draws any (implementation-specific) borders, regardless whether content is available 
or not. Note that by default the background mode is set to not paint a background. Furthermore on platforms 
which support transparent colours the background colour may be partially or completely transparent. 

Any resources explicitly associated with this look shall be loaded by it during its creation. Note that the "standard" 
looks do not load content by default. 

This method is called from the paint () method of HVisible and must never be called from elsewhere. 
Components wishing to redraw themselves shall call their repaint method in the usual way or call 
widgetChanged ( ) under certain circumstances. 

The labels of the associated HListElements shall be rendered by using the current text layout manager of the 
HListGroup. For each visible label is the render ( ) method of HTextLayoutManager called. The 
position and size per label are specified as insets relatively to the bounds ofHListGroup. Note that the bounds 
are independent of any borders of the HListGroup, but the insets have to include the borders per element, if 
any. The look shall use the method get Label Size ( ) ofHListGroup to determine the size for each label. If 
the returned dimension object has DEFAULT_LABEL_WIDTH for the width and/or DEFAULT_LABEL_ 
HEIGHT for the height as values, then this method shall use implementation specific value(s) as default(s) for the 
missing dimension(s) instead. If getlextLayoutManager ( ) returns null, then labels shall not be rendered. 

If supported, scaling of icons shall reflect the resize mode of the visible within the area of the respective list 
element. The look shall use the method getlconSize ( ) ofHListGroup to determine the size for each icon. 
If the returned dimension object has DEFAULT_ICON_WIDTH for the width and/or DEFAULT_ICON_HE IGHT 
for the height as values, then this method shall use implementation specific value(s) as default(s) for the missing 
dimension(s) instead. 

Except for the alignment of labels and sizes of labels and icons, it is explicitly not defined, how this look arranges 
icons and labels within the elements' areas. Additionally, it is an implementation option to render labels and icons 
in other sizes than specified, if the available size per element is smaller or larger than label and icon size. It is also 
not defined, how the look presents the current item and selected items, or the current selection mode. The 
elements shall be layed out as specified by getOrientation ( ) of the associated HListGroup. 

When the associated HLi stGroup contains more elements than presentable, the look shall make the user aware 
of that condition, e.g. by displaying an additional scrollbar reflecting the current scroll position. Again, the visible 
means by which this information is conveyed is not defined and implementation dependent. It is an 
implementation option for HListGroup Look to draw elements before the scroll position, in order to fill the 
available space. 

The behaviour of this method, when a subclass overrides the methods get Inset s ( ) or 
getElementlnsets ( ) , is not defined. Application developers shall not assume that the corresponding 
borders will appear as specified. 

Parameters: 

g the graphics context. 

visible the visible. 

state the state parameter indicates the state of the visible, allowing the look to render the appropriate 

content for that state. Note that the default behaviour of HLi stGroupLook is to ignore this parameter, since the 
content ofHListGroup is not state based. See also: 

Java . awt . Component . getBounds ( ) 
Java . awt . Graphics . getClipBounds ( ) 
HListGroup. getCurrentltem ( ) 
HListGroup. getListContent () 
HListGroup .getOrientation () 
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HList Group. getScrollPosition ( ) 
HLi St Group .setIconSize() 
HList Group. setLabelSize ( ) 
HLi St Group. isItemSelected ( ) 
HTextLayoutManager . render ( ) 

A. 7. 4. 16. 7 Class description 

The following sentence shall be considered to be removed. 
Borders are not drawn around the content. 

A. 7. 4. 16. 8 sliowLool< and renderVisible 

The five paragraphs in showLook starting with "The labels of the associated HListElements shall be rendered..." and 
ending "...Application developers shall not assume that the corresponding borders will appear as specified." shall be 
considered to form part of the renderVisible method instead. 

A.7.4.16.9 renderVisible 

The following shall be considered to be added to the end of this method description: 

The org.havi.ui.HExtendedLook.renderVisible method is responsible for painting any implementation specific 
borders for each HListElement as well as drawing of an additional scrollbar if required. 

A.7.4.17 HLook 
A.7.4.17.1 General 

In the description of HLook and all implementing classes, the term clipRect shall be interpreted to mean "clipping 
rectangle". 

A.7.4.17.2 Class description 

Only the first paragraph of the "Invocation Mechanism" section shall be considered to be present. 

A.7.4.17.3 getPreferredSize 

In the description of this method, the text: 

"... then the return value is the size of the largest piece of content..." 
shall be considered to be replaced with: 

"...then the return value is a size that is sufficiently large to hold each piece of content..." 
The equivalent replacement shall apply for getMinimumSize ( ) and getMaximumSize ( ) . 

In HLook and all classes implementing this interface, the following text shall be considered to form part of the method 
description of getPreferredSize(): 

Ifa default preferred size has been set for this HVisible (using setDefaultSize (Dimension) ) and the 
default preferred size has anNO_DEFAULT_WIDTH then the return value is a Dimension with this height 
(obtained with getDefaultSizeO ) and the preferred width for the content plus any additional dimensions 
that the HLook requires for border decoration etc. 

If a default preferred size has been set for this HVisible (using setDefaultSize (Dimension) )andthe 
default preferred size has anNO_DEFAULT_HEIGHT then the return value is a Dimension with this width 
(obtained with getDefaultSizeO ) and the preferred height for the content plus any additional dimensions 
that the HLook requires for border decoration etc. 

A.7.4.17.4 showLook 

In org . havi . ui . HLook . showLook ( ) , the text; 

The showLook method should not modify the clipRect of the Graphics object that is passed to it. 
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Shall be clarified as follows: 

The showLook method shall not modify the clipRect (clipping rectangle) of the Graphics object passed to 
it in a way which includes any area not part of that original clipRect. If any modifications are made, the 
original clipRect shall be restored. 

A.7.4.18 HMultilineEntry 

The following text shall be considered to be added to the class description: 

A call to the inherited method setDef aultLook (HSinglelineEntry) shall behave the same as a call to 

HS ingle lineEntry . setDef aultLook (HSinglelineEntry) . 

A.7.4.19 HMultilineEntryLook 

A.7.4.19.1 getCaretCharPositionForLine 

The following text: 

If an invalid line is specified an IllegalArgumentException is thrown If it cannot be moved the nearest 
position should be returned 

shall be considered to be replaced by: 

If an invalid line is specified an IllegalArgumentException is thrown. If the caret cannot be moved to the 
same column position on this line, the nearest position should be returned. 

A.7.4.19.2 getSoftLineBreakPositions 

The following text shall be considered to be added to the returns clause of this method 

If there is no text content within the HVisible, a zero length array shall be returned. 

A.7.4.19.3 getVisibleSoftLineBreakPositions 

The following text is considered be added to the returns clause of this method 

If there is no text content within the HVisible, a zero length array shall be returned. 

A.7.4.20 HNavigable 
A.7.4.20.1 Class description 

In the following sentence: 

Applications should assume that classes which implement HNavigable can only generate events of the type 
HFocusEvent in response to other types of input event. 

The word "only" shall be considered to be not present. 

A.7.4.20.2 setMove 

All occurrences of "then null should be specified" shall be considered to be replaced by "then null shall be specified". 

A.7.4.20. 3 set FocusTraversal 

All occurrences of "then null should be specified" shall be considered to be replaced by "then null shall be specified". 

A.7.4.21 HOrientable 

A. 7. 4. 21.1 Interface description 

The following text: 

All interoperable implementations of the HOrientable interface must extend HComponent. 
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Is considered to be replaced with: 

Widgets of HAVi compliant applications implementing the HOrientable interface must have HComponent in 
their inheritance tree. 

A.7.4.21.2 getOrientation 

The following text: 

The orientation controls how an associated HLook lays out the component and affects the visual behaviour of the 
HAd justmentEvent and HItemEvent events. For example, the system might use this information to select 
appropriate key mappings for these events. 

Is considered to be replaced with: 

The orientation controls the layout of the component. 

A.7.4.21.3 setOrientation 

The following text: 

The orientation controls how the associated HLook lays out the component. 
Is considered to be replaced with: 

The orientation controls the layout of the component. 
A.7.4.21.3.1 Orientation constants 

In the description of the orientation constants: ORIENT_LEFT_TO_RIGHT, ORIENT_RIGHT_TO_LEFT, ORIENT_ 
TOP_TO_BOTTOM and ORIENT_BOTTOM_TO_TOP the word "shall" is considered to replace "should' in each instance 
of the phrase "should be rendered". 

A.7.4.22 HScene 

A.7.4.22.1 addAfter, addBefore 

In the returns clause, the text: 

is successfully added 
shall be considered to read: 

is successfully added or was already present. 
A.7.4.22.2 getFocusOwner 

The following text shall be considered to be added to the end of the method description: 

if and only if this HScene is active. 

A.7.4.22. 3 Rendering behavior 

The following text shall be considered to form an additional paragraph under this heading. 

An application which sets both of setBackgroundMode(NO_BACKGROlJND_FILL) and 
setImageMode(IMAGE_NONE) shall be responsible for ensuring that all pixels in the Hscene are filled with a 
value which is either opaque or transparent only to video. Such an application cannot make any assumptions about 
the previous contents of the graphics objects into which it is drawing. For implementations which double-buffer 
the display of graphics, these existing contents are implementation dependent. 

A.7.4.23 HScreenConfigurationListener 

The parameter "gee" for the report method shall be considered to have the following description. 

gee - The event notifying the listener of the modification. 
Add to errata to external references - HAVi 
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A.7.4.24 HSceneFactory 
A.7.4.24.1 getDefaultHScene 

The text: 

. . . identical to calling org.liavi.ui.HScene.getDefaultHscene( 
shall be considered to read: 

...identical to calling org.havi.ui.HSceneFactory.getDefaultHscene( 

A.7.4.24.2 Class Description 

The following text 

Calling resizeScene for an HScene shall apply the same policies as described above for newly created HScenes 
when deciding whether the resizing operation requested is possible. 

Shall be considered to read: 

Calling resizeScene for an HScene shall apply the same policies as described above for newly created HScenes 
when deciding whether the method call is possible. 

A.7.4.25 HSelectionlnputPreferred 
A. 7. 4. 25.1 Interface description 

The following text is considered to be added to the interface description: 

The system must provide a means of generating HItemEvent events as necessary. For platforms with a 
restricted number of physical keys this may involve a "virtual keyboard" or similar mechanism.The system might 
use the information returned by the method getOrientation () of the super interface to select appropriate 
key mappings for this event. The mechanisms to generate this event shall not be effective while the component is 
disabled (see HComponent . setEnabled ( ) ). 

Also, the text: 

All interoperable implementations of the HSelectionlnputPreferred interface must extend 

HComponent. 

Is considered to be replaced with: 

Widgets of HAVi compliant applications implementing the HSelectionlnputPreferred interface must 
have HComponent in their inheritance tree. 

Also, in the text: 

Note that the Java . awt . Component method isFocusTraversable should always return true for a 
Java . awt . Component implementing this interface. 

The word "should" is considered to be replaced with "shall". 
A.7.4.25.2 getSelectionMode 

The description of this method is considered to be extended by the following text: 

Note that these events are ignored, if the component is disabled. See also: HComponent . setEnabled ( ) . 

A. 7. 4. 25. 3 processHltemEvent 

The description of this method is considered to be extended by the following text: 

Widgets implementing this interface shall ignore HItemEvents, while the component is disabled. See also: 

HComponent . setEnabled ( ) . 
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A.7.4.25.4 setSelectionMode 

The description of this method is considered to be extended by the following text: 

Calls to this method shall be ignored, if the component is disabled. See also: HComponent . setEnabled ( ) . 

A.7.4.26 HSingleLineEntry 
A.7.4.26.1 Class description 

The term: 

TEXT_START_CHANGE event 
is considered to be replaced with: 

an HTextEvent event with an id of TEXT_START_CHANGE. 

A. 7. 4. 26. 2 Default parameter values not exposed in the constructors 

In the row "Password protection (the echo character)", in the "default value" column, replace 

Entry is "clear", i.e. not password protected, 
with: 

Zero (ASCII NUL), i.e. not password protected. 
A.7.4.26.3 setType(int) 

The following text: 

Set the type of permitted keyboard entry. 
Parameters: 

type - one of INPUT_ANY, INPUT_ALPHA, INPUT_NUMERIC or INPUT_CUSTOMIZED 
Shall be considered to be replaced with: 

Set to indicate to the system which input keys are required by this component. The input type constants can be 
added to define the union of the character sets corresponding to the respective constants. 

Parameters: 

type - sum of one or several of INPUT_ANY, INPUT_NUMERIC, INPUT_ALPHA, 
or INPUT_CUSTOMIZED. 

A.7.4.26.4 getValidlnput 

The following text: 

Retrieve the customized input character range. The return value of this method should reflect the range of input 
keys which the component wishes to see, should getType return a value with the INPUT_CUSTOMIZED bit set. 
This method may return null if customized input is not requested. 

shall be considered to be replaced with 

Retrieve the customized input character range. If getType returns a value with the INPUT_CUSTOMIZED bit set 
then this method shall return an array containing the range of customized input keys. If the range of customized 
input keys has not been set then this method shall return a zero length char array. This method shall return null if 
getType returns a value without the INPUT_CUSTOMIZED bit set. 
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k.lA.21 HStaticAnimation 

The following text is considered to be added to the description of this class: 

Calling setvisible (false) on HStaticAnimation shall not automatically stop the animation hence 
applications are not required to call the play ( ) method again when the animation again becomes visible. It is 
implementation dependent whether the animation continues from the last visible position or from where it would 
be if it kept running. 

A.7.4.28 HStaticRange 

A.7.4.28.1 Fields 

A.7.4.28. 1.1 SCROLLBAR_BEHAVIOR 

The description of this field is considered to be replaced by the following text: 

The HStaticRange shall behave as a scrollbar, i.e. the allowable values that may be set / returned for the 
HStaticRange shall be affected by the "thumb" offsets, and hence its value shall be able to vary between 

[minimum + minThumbOf f set , maximum - maxThumbOf f set ] . 

A.7.4.28. 1.2 SLIDER_BEHAVIOR 

The description of this field is considered to be replaced by the following text: 

The HStaticRange shall behave as a slider, i.e. the allowable values that may be set / returned for the 
HStaticRange shall not be affected by the "thumb" offsets, and hence its value shall be able to vary between 

[minimum, maximum] . 

A.7.4.28.2 getOrientation 

The following text: 

The orientation controls how an associated HLook lays out the component and affects the visual behaviour of the 
HAd justmentEvent and HItemEvent events. For example, the system might use this information to select 
appropriate key mappings for these events. 

Is considered to be replaced by: 

The orientation controls how the associated HLook lays out the component. 

A.7.4.28. 3 setBehavior 

The following text is considered to be appended to the method description: 

If the new behaviour is SCR0LLBAR_BEHAVI0R and the control's settings for range and thumb offsets are 
illegal, i.e. minimum + thumbMinOf f set is equal or greater than maximum - thumbMaxOf f set, then an 
IllegalArgumentException shall be thrown. If the control's value is not valid for the offsets, then the 
value shall be changed to the closest valid value. 

A.7.4.28.4 setRange 

The following text is considered to be appended to the method description: 

If the maximum is greater than the minimum and the value of the control is outside the new range (subject to the 
control's current behaviour), then the value is changed to the closest valid value. 

A.7.4.28. 5 setThumbOffsets 

The following text is considered to be appended to the method description: 

If this control's behaviour is SCR0LLBAR_BEHAVI0R, then the following rules apply: If the thumb offsets are 
illegal, i.e. minimum + thumbMinOf f set is equal or greater than maximum - thumbMaxOf f set, then an 
IllegalArgumentException shall be thrown. If the control's value is not valid for the specified offsets, 
then the value shall be changed to the closest valid value. 
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A.7.4.28.6 setValue 

The method's parameter description is considered to be replaced by: 

value - the value for this HStaticRange 
Also, the following text is considered to be appended to the method description: 

If the specified value is not valid, then the method shall round it to the closest valid value. An application can 
retrieve the corrected value by means of method getValue ( ) . 

A.7.4.29 HVideoDevice 
A.7.4.29.1 getBestConfiguration 

The following text is considered to be added to the end of the second paragraph of the descriptions of both methods of 
this name. 

If there are such equally best configurations, the one which is returned by this method is an implementation 
dependent selection from among those which are equally best. 

A.7.4.29.2 setVideoConfiguration 

In the setVideoConfiguration method, the sentence below: 

Applications can prevent or limit changes to configurations of other, not intended, devices by using constants 
ZERO_GRAPHICS_IMPACT and ZERO_VIDEO_IMPACT in their configuration templates. 

shall be considered to be extended as follows: 

Applications can prevent or limit changes to configurations of other, not intended, devices by using constants 
ZERO_GRAPHICS_IMPACT, ZERO_VIDEO_IMPACT and ZERO_BACKGROUND_IMPACT in their 
configuration templates. 

The following additional text is considered to be present; 

NOTE: If a configuration which includes ZERO_GRAPHICS_IMPACT or ZERO_BACKGROUND_IMPACT 
and this would require changes to already running devices then this will not be possible to apply successfully and 
hence this method will return False. 

A.7.4.29. 3 getVideoController 

The following text: 

HPermissionDeniedException - (HPermissionDeniedException) if the application does not currently have the 
right to get the VideoPlayer object. 

shall be considered to be replaced by: 

HPermissionDeniedException - (HPermissionDeniedException) this exception shall never be thrown. 

A.7.4.29.4 setVideoConfiguration 

The following shall be added as the first item in the bulleted list: 

• If an application tries to select a configuration which is not valid for that device at that time or when the device is 
in a particular mode then an HConfigurationException shall be thrown. 

A.7.4.29. 5 getConfigurations 

The following shall be added to the end of the method description. 

• The set of configurations returned may include ones which are only valid for the device at particular times or 
when the device is in a particular mode. 
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A.7.4.30 HVisible 
A.7.4.30.1 Class description 

In the class description of HVisible, the sentence: 

Most content is stored by reference, but text content is copied as Java . lang. String objects are immutable, 
shall be considered to not be present. 

In the table "Default parameter values not exposed in the constructors", row "getDefaultSize", column "Default value" 
the following text: 

The default preferred size not set (i.e. null) unless specified by width and height parameters 
Shall be considered to be replaced with: 

The default preferred size not set (i.e. NO_DEFAULT_SIZE) unless specified by width and height parameters 
A.7.4.30.2 Constructors 

The following text shall be considered to form part of those constructor descriptions which have an HLook as a 
parameter: 

Applications shall not use HLooks with this constructor unless those HLooks are specified as working with 
HVisible. If an HLook is used which is specified as only working with specific sub-classes of HVisible then 
the failure mode is implementation dependent. 

A.7.4.30. 3 setDefaultSize 

The following text: 

If this parameter or specifies a size smaller than an implementation-defined minimum size a j ava . lang . 

IllegalArgumentException will be thrown. 

Shall be considered to be replaced by: 

If this parameter specifies a size smaller than an implementation-defined minimum size, the preferred size of this 
component shall be set to that implementation-defined minimum size. 

Also, the following text: 

If the parent Container into which the HVisible is placed has no layout manager this method has no effect. 
Is considered to be removed. 

A.7.4.30.4 setLool<Data 

The method description shall be considered to have the following text added. 

If for this specified key a data object has been set, the old data object shall be replaced with the new one. 

A.7.4.30. 5 setResizeMode 

The following text added shall be considered to be replaced: 

Set the scaling mode for scaling any state-based content rendered by an associated HLook. If content is not used 
in the rendering of this HVisible calls to this method shall change the current alignment mode, but this will not 
affect the rendered representation. 



by: 



Set the resize mode of this HVisible. If the associated HLook does not render content or if scaling is not 
supported, changing the mode may have no visible effect. 
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A.7.4.30.6 setTextContent 

In the description of this method, the following sentence is considered to not be present: 

Note that unlike setGraphicContent, setAnimateContent and setContent, the content is copied as 
it is not possible to store a reference to a j ava . lang . St ring. 

A.7.4.30.7 NO_DEFAULT_SIZE 

The following text shall be considered to be appended to the end of the field description. 

The contents of the Dimension object cannot be relied upon. Comparisons must always be done using object 
identity, i.e. using the ' -=" operator. 

A.7.4.31 HVideoConfigTemplate 

A.7.4.31.1 setPreference 

The paragraph: 

An application which wishes to remove a preference from an existing template (e.g. one generated by the 
platform) may call this method with null for the object parameter. 

Shall be considered to be extended with the following sentence: 

Specifying null as the object parameter shall have no effect if the preference is not in the template. 

A.7.4.32 HVideoComponent 

In section 8.3.3.6 "Integrating HAVi Video Support into Platforms" the following sentence: 

In platforms based on the Java Media Framework, the Player.getVisualComponent method shall return objects of 
this class. 

Shall be considered to be extended with the following text: 

or null if the platform does not support video in components. 

A.7.4.33 HBackgroundConfiguration 
A.7.4.33.1 setColor 

The "throws" clause for HPermissionDeniedException shall be considered to read as follows 

If the application has not currently reserved the HBackgroundDevice associated with this configuration or this 
configuration is not the current configuration of that HBackgroundDevice. 

A.7.4.33.2 getConfiglemplate 

The following text shall be considered to be added to the description of this method: 

Preferences that are not filled in by the platform will return DONT_CARE priority. 

A.7.4.34 HScreenDevice 
A. 7. 4. 34.1 reserveDevice 

The following paragraph: 

Once the right to control this device has been granted and not removed in the intervening period further calls to 
this method shall have no effect and return true. 

Shall be considered to be replaced by: 

Once the right to control this device has been granted and not removed in the intervening period further calls to 
this method re-using the current resource client shall have no effect and return true. 
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A.7.4.35 HImageMatte 

A.7.4.35.1 setMatteData 

The method setMatteData shall be considered to have the following text added; 

Note that if the size of the image is smaller than the size of the component to which the matte is applied, the empty 
space behaves as if it were an opaque flat matte of value 1 .0. By default images are aligned at the top left comer of 
the component. This can be changed with the setOffset method. 

A.7.4.36 HVersion 
A.7.4.36.1 General 

The following text; 

Note that it is a valid implementation to return empty strings for the implementation, vendor and name strings, 
shall be considered to be replaced with 

Note that it is a valid implementation to return empty strings for HAVI_IMPLEMENTATION_NAME, HAVI_ 
IMPLEMENTATION_VENDOR and HAVI_IMPLEMENTATION_VERSION strings. 

A.7.4.36.2 MHP Specific Clarification 

In MHP, a call to getProperty ( ) when referencing the constants listed in column Constant in the table below shall 
return a string as listed in column Value. 

Table A.2 : getProperty 



Constant 


Value 


HAVI_SPECIFICAriON_VENDOR 


"DVB" 


HAVI_SPECIFICAriON_NAME 


"MHP" 


HAVI_SPECIFICAriON_VERSION 


"<version>" 



<version>: this string shall represent the MHP version to which this HAVi implementation is conformant. The 
encoding shall be, in order, the major, minor and micro values from table 69, "Profile encoding" on page 232 presented as 
the textual representation of decimal integers with no leading zeros and separated by a single "." character, e.g. "1.0.3". 

A.7.4.36. 3 Field descriptions 

Consider all occurrences of: Java. lang.System.getProperty(havi. specification. version) 

to be replaced with: java.lang.System.getProperty(HVersion.HAVI_SPECIFICATION_VERSION) 

and all occurrences of: Java. lang.System.getProperty(havi. specification. vendor) 

to be replaced with: java.lang.System.getProperty(HVersion.HAVI_SPECIFICATION_VENDOR), 

and all occurrences of: java.lang.System.getProperty(havi.specification.name 

to be replaced with: java.lang.System.getProperty(HVersion.HAVI_SPECIFICATION_NAME), 

all occurrences of: java.lang.System.getProperty(havi. implementation. version) 

to be replaced with: java.lang.System.getProperty(HVersion.HAVI_IMPLEMENTATION_VERSION), 

and all occurrences of java.lang.System.getProperty(havi.implementation.vendor) 

to be replaced with: java.lang.System.getProperty(HVersion.HAVI_IMPLEMENTATION_VENDOR) 

and all occurrences of: Java. lang.System.getProperty(havi. implementation. name) 

to be replaced with: java.lang.System.getProperty(HVersion.HAVI_IMPLEMENTATION_NAME). 
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A.7.4.37 HKeyboardlnputPreferred 

A.7.4.37.1 INPUT_NUMERIC 

The following text: 

This constant indicates that the component only requires alphanumeric input, as determined by the java.lang. 
Character isDigit method. 

shall be considered to be replaced by: 

This constant indicates that the component requires numeric input, as determined by the java.lang. Character 
isDigit method. 

A.7.4.37.2 INPUT_ALPHA 

The following text: 

This constant indicates that the component only requires alphanumeric input, as determined by the java.lang. 
Character isLetter method. 

shall be considered to be replaced by: 

This constant indicates that the component requires alphabetic input, as determined by the java.lang. Character 
isLetter method. 

A.7.4.37.3 getValidlnput 

The following text: 

Retrieve the customized input character range. The return value of this method should reflect the range of input 
keys which the component wishes to see, should getType return a value with the INPUT_CUSTOMIZED bit set. 
This method may return null if customized input is not requested. 

shall be considered to be replaced with: 

Retrieve the customized input character range. If getType returns a value with the INPUT_CUSTOMIZED bit set 
then this method shall return an array containing the range of customized input keys. If the range of customized 
input keys has not been set then this method shall return a zero length char array. This method shall return null if 
getType returns a value without the INPUT_CUSTOMIZED bit set. 

A.7.4.38 HScreenConfigTemplate 

A.7.4.38.1 Class description 

The following text shall be considered to be added to the end of the class description: 

Several preferences in this class are required to be not filled in by the platform in templates generated by the 
platform. This shall mean; 

- the object for this preference (if there is one) is set to null 

- the priority for this preference is set to DONT_CARE 

A.7.4.39 HGraphicsConfiguration 

A.7.4.39.1 getConfiglemplate 

The following text shall be considered to be added to the description of this method: 

Preferences that are not filled in by the platform will return DONT_CARE priority. 
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A.7.4.40 HVideoConfiguration 

A.7.4.40.1 getConfigTemplate 

The following text shall be considered to be added to the description of this method: 

Preferences that are not filled in by the platform will return DONT_CARE priority. 

A.7.4.41 HToggleButton 

A. 7. 4. 41 .1 Default parameter values exposed in the constructors 

The following descriptions will be used to replace the ones already in HToggleButton's "Default parameter values 
exposed in the constructors" table: 

imageFocused - The image to be used as the content for the HState.FOCUSED_STATE and HState.DISABLED_ 
FOCUSED_STATE states of this component. 

imageActioned - The image to be used as the content for the HState.ACTIONED_FOCUSED_STATE and 
HState.DISABLED_ACTIONED_FOCUSED_STATE states of this component. 

imageNormalActioned - The image to be used as the content for the HState.ACTIONED_STATE and HState. 
DISABLED_ACTIONED_STATE states of this component. 

A.7.4.42 HGraphicButton 

A. 7. 4. 42.1 Default parameter values exposed in the constructors 

The following descriptions will be used to replace the ones already in HGraphicButton's "Default parameter values 
exposed in the constructors" table: 

imageFocused - The image to be used as the content for the HState.FOCUSED_STATE and HState.DISABLED_ 
FOCUSED_STATE states of this component. 

imageActioned - The image to be used as the content for the HState.ACTIONED_STATE, HState.ACTIONED_ 
FOCUSED_STATE states of this component. 

A.7.4.43 HTextButton 

A. 7. 4. 43.1 Default parameter values exposed in the constructors 

The rows for textFocus and textAction in HTextButton's "Default parameter values exposed in the constructors" table 
shall be considered to be removed. 

A.7.4.44 HLook and classes implementing HLook 

In the getMinimumSize method of HLook and all these classes, the following paragraph shall be considered to be 
replaced: 

If the HLook supports the scaling of its content (e.g. an HGraphicLook) and content is set then the return value is 
a size sufficiently large to hold the minimum size of each piece of content plus any additional dimensions that the 
HLook requires for border decoration etc. 

with: 

If the HLook supports the scaling of its content (e.g. an HGraphicLook) and scaling is requested and content is set 
then the return value is a size containing the width of the narrowest content and the height of the shortest content 
plus any additional dimensions that the HLook requires for border decoration etc. 

A.7.4.45 HTextLook 

A.7.4.45.1 General 

In getMaximumSizeO, getMinimumSize() and getPreferredSize(), the following sentence: 

If the HDefaultTextLayoutManager returns a zero size, then proceed with the following steps. 
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shall be considered to be replaced with the following: 

If HVisible.getTextLayoutManager() does not return an instance of HDefaultTextLayoutManager, or 
HDefaultTextLayoutManager returns a zero size, then proceed with the following steps as if content for this 
HVisible had not been set. 

A.7.4.46 H Extended Look 



org.havi.ui 

HExtendedLook 



Syntax 

public interface HExtendedLook extends HLook 

All Superinterfaces: 

java.lang.Cloneable, HLook 

Description 

The HExtendedLook interface is derived from the HLook interface and abstracts out tine drawing of tine 
lool< into separate bacl<ground, border and visible data components. Tine interface allows the 
programmer to derive new looks from the default looks and have control over which component parts are 
drawn. This aids interoperability between platforms since no two manufacturer's HLook implementation 
look the same. 

See Also: 

setLook (HLook) , setLookData (Object, Object), paint (Graphics) , 
setBackgroundMode (int) , setHorizontalAlignment (int) , 

setVerticalAlignment (int) , setResizeMode (int) , HTextLook, HGraphicLook, 
HAnimateLook, HRangeLook, HSinglelineEntryLook, HMultilineEntryLook 



Methods 

fillBackground(Graphics, HVisible, int) 

public void fillBackground (j ava . awt . Graphics g, HVisible visible, int state) 

The fillBackground(Graphics, HVisible, int) method paints the component with its current 
background Color according to the setBackgroundMode (int) method of HVisible . 

This method is only called from showLook within this HExtendedLook implementation. It's not the 
intention to call this method directly from outside of the HExtendedLook. 

Regardless of the background mode, it is an implementation option for this method to render added 
decorations which may affect the look's transparency. This method shall not be used to render any 
HVisible related data or content associated with the HVisible. It is purely for background and 
decoration only. 

The fillBackground method should not modify the clipRect (clipping rectangle) of the Graphics 
object that is passed to it in a way which includes any area not part of that original clipRect. If any 
modifications are made, the original clipRect shall be restored. 

Parameters: 

g - the graphics context. 
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visible - the visible. 

state - tine state parameter indicates tine state of tine visible 

See Also: 

isOpaque (HVisible) 

renderBorders(Graphics, HVisible, int) 

public void renderBorders (j ava . awt . Graphics g, HVisible visible, int state) 

The renderBorders(Graphics, HVisible, int) method paints any implementation specific borders 
according to the setBordersEnabled (boolean) method of HVisible . If borders are drawn, 
the border decoration shall be rendered within the border area as returned by getinsets. The 
behavior of this method, when a subclass overrides the method getinsets is undefined, except 
that it will never draw outside the border area as returned by getinsets. 

This method is only called from showLook within this HExtendedLook implementation. It's not the 
intention to call this method directly from outside of the HExtendedLook. 

The renderBorders(Graphics, HVisible, int) method should not modify the clipRect (clipping 
rectangle) of the Graphics object that is passed to it in a way which includes any area not part of 
that original clipRect. If any modifications are made, the original clipRect shall be restored. 

Parameters: 

g - the graphics context. 

visible - the visible. 

state - the state parameter indicates the state of the visible 

renderVisible(Graphics, HVisible, int) 

public void renderVisible (j ava . awt . Graphics g, HVisible visible, int state) 

The renderVisible(Graphics, HVisible, int) method paints any content or other data associated with 
the look's HVisible. This method shall not be used to render a background nor any other decoration. 
Its purpose is purely to render content or other value data stored on the HVisible. This may be set via 
HVisible methods such as setTextContent and setGraphicContent. Rendering shall take 
place within the bounds returned by the getinsets method. 

This method is only called from showLook within this HExtendedLook implementation. It's not the 
intention to call this method directly from outside of the HExtendedLook. 

For looks which draw content (e.g. HTextLook , HGraphicLook and HAnimateLook ), if no 
content is associated with the component, this method does nothing. 

The renderVisible(Graphics, HVisible, int) method should not modify the clipRect (clipping 
rectangle) of the Graphics object that is passed to it in a way which includes any area not part of 
that original clipRect. If any modifications are made, the original clipRect shall be restored. 

Parameters: 

g - the graphics context. 

visible - the visible. 

state - the state parameter indicates the state of the visible 

showLook(Graphics, HVisible, int) 

public void showLook (j ava . awt . Graphics g, HVisible visible, int state) 

The showLook(Graphics, HVisible, int) method is the entry point for repainting the entire HVisible 
component. This method delegates the responsibility of drawing the component background, 
borders and any HVisible related data or content to the f illBackground, renderVisible and 
renderBorders methods respectively, subject to the clipping rectangle of the Graphics object 
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passed to it. This metlnod sinall call the methods f illBackground, rendervisible, and 
renderBorders in that order and shall not do any rendering itself. 

The showLook(Graphics, HVisible, int) method should not modify the clipRect (clipping rectangle) of 
the Graphics object that is passed to it in a way which includes any area not part of that original 
clipRect. If any modifications are made, the original clipRect shall be restored. 

Any resources explicitly associated with an HExtendedLook should be loaded by the 
HExtendedLook during its creation, etc. Note that the "standard" looks don't load content by default. 

This method is called from the paint (Graphics) method of HVisible and must never be called 
from elsewhere. Components wishing to redraw themselves should call their repaint method in the 
usual way. 

Overrides: 

showLook(Graphics, HVisible, int) in interface HExtendedLook 

Parameters: 

g - the graphics context. 

visible - the visible. 

state - the state parameter indicates the state of the visible, allowing the look to render the 
appropriate content for that state. Note that some components (e.g. HStaticRange, HRange, 
HRangeValue) do not use state-based content. 

A.7.4.47 HAnimateLook, HGraphicLook, HListGroupLook, 
HMultilineEntryLook, HRangeLook, 
HSinglelineEntryLook and HTextLook 

The following changes shall be considered to apply to all these implementing looks. 

a) The method descriptions in HExtendedLook for fillBackground(), renderBorders() and render Visible() shall be 
considered to form part of all the above looks. 

b) The description of showLook() in each of the above looks shall be considered to be replaced with the one in 
HExtendedLook. 

c) HAnimateLook, HGraphicLook, HSinglelineEntryLook and HTextLook shall be considered to implement 
HExtendedLook instead of HLook. 

d) HListGroupLook and HRangeLook shall be considered to implement HExtendedLook additionally to 
HAdjustableLook. The method showLook() shall be implemented as specified by HExtendedLook. 

A.7.5 org. havi.ui. event 
A.7.5.1 HActionEvent 

The text: 

Modifiers are not used with the HAVi platform. Interoperable HAVi applications shall not use the return value of 
this method. 

shall be considered to be replaced by: 

Modifiers are not used for HActionEvents with the HAVi platform. Interoperable HAVi applications shall not 
use the return value of this method. 
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A.7.5.2 HItemEvent 

A.7. 5.2.1 Constructor 

The following text: 

item - The item which caused the change, or null if this information is not available. This information shall be 
provided if the event id is one of ITEM_SELECTED, ITEM_CLEARED, ITEM_SET_CURRENT, ITEM_SET_ 
NEXT or ITEM_SET_PREVIOUS. 

Shall be considered to be replaced with the following: 

item - The item which caused the change, or null if this information is not available. 

If the event is sent to listeners, this information shall be provided if the event id is one of ITEM_SELECTED, 
ITEM_CLEARED, ITEM_SET_NEXT or ITEM_SET_PREVIOUS." 

A.7.5.2.2 ITEM_SET_CURRENT 

The following paragraph: 

An item event with this id is sent from the component whenever the current item of an HItem Value component 
changes. 

Shall be considered to be replaced with: 

An item event with this id is sent to or from the component whenever the current item of an HItem Value 
component changes. 

A.7.5.3 HKeyEvent 

The following paragraph shall not apply in this specification: 

Note that the HAVi system should only generate KEY_PRESSED events. Neither KEY_TYPED nor KEY_ 
RELEASED events should be generated. Furthermore, the system should collapse combined events. For example, 
a usual Java Virtual Machine generates for the letter A three events: KEY_PRESSED for modifier key Shift, 
KEY_PRESSED for letter "A" and KEY_TYPED for "A". This should be collapsed into one single KEY_ 
PRESSED event with the letter "A" and the Shift modifier set. This is to simplify the key event handling of 
applications. 

A.7.5.3. 1 Constructors 

The description of the "id" parameter shall be considered to have the following text added: 
This is the value that will be returned by the event object's getID method. 

A.7.5.4 HRcEvent 

The following changes shall be considered to apply in this class: 

• Replace all occurrences of "action id" in the descriptions of the VK constants by "key code". 

• Replace all occurrences of "event ids" in the descriptions of RC_FIRST and RC_LAST by "key codes". Tag both 
constants as being deprecated. Add for RC_FIRST a specific deprecated text: 

* @deprecated The value of this field is useless, since it mixes event ids and key codes. It does not reflect any of 
the remote control key codes listed in this class. 

• Remove the following sentence from the class description: "Note that it is an implementation constraint that the 
HrcEvent event range should not intersect with the Java AWT key event range." 

• Add to the parameter descriptions of "id" for both constructors: "in the range KEY_FIRST to KEY_LAST". 

A.7.5.5 HRcCapabilities 

In the method isRepresentation (int aCode) , all references to the parameter id shall be considered to be 
replaced with keyCode. 
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A.7.5.6 HEventGroup 

A.7. 5.6.1 getKeyEvents 

This class shall be considered to be extended with the following method: 

/** 

* Return the key codes contained in this event group 
*/ 
public int [ ] getKeyEvents ( ) {} 

A.7.6 References to IS0/IEC1 0646-1:1 993 

All references to ISO/IEC 1 0646-1 : 1993 are considered to be non-specific references to ISO 10646-1 [18]. Also, the term 
"support for Unicode ranges" is considered to be "support for character ranges as specified by ISO 10646-1 [18]". 

A.8 ISO/IEC 13818-6 [26] 

A.8.1 Reconstruction of NPT 

In equation 8-3, SCR_Reference is considered to be STC_Reference. 

A.9 JAE 1.1.8 const [72] 

The constants listed below shall have the values given below and not those in the normative reference; 

public final static float Java. awt . Component . TOP_ALIGNMENT = O.Of; 

public final static float Java . awt . Component .CENTER_ALIGNMENT = 0.5f; 

public final static float Java . awt . Component .BOTTOM_ALIGNMENT = l.Of; 

public final static float Java . awt . Component . LEFT_ALIGNMENT = O.Of; 

public final static float Java . awt . Component .RIGHT_ALIGNMENT = l.Of; 

public final static long Java . lang . Long .MIN_VALUE = OxSOOOOOOOOOOOOOOOL; 

public final static long Java . lang. Long. MAX_VALUE = 0x7f f f f f f f f f f f f f f f L; 

public final static float Java . lang. Float .NEGATIVE_INFINITY = -1. Of/0. Of; 

public final static float Java . lang. Float .POSITIVE_INFINITY = 1. Of/0. Of; 

public final static float Java. lang. Float .NaN = O.Of/O.Of; 

public final static double Java . lang . Double . POSITIVE_INFINITY = 1.0/0.0; 

public final static double Java . lang. Double .NEGATIVE_INFINITY = -1.0/0.0; 

public final static double Java . lang. Double .NaN = 0.0/0.0; 

public static final float Java . lang. Float .MIN_VALUE = 1 . 40129846432481707e-45f ; 

public final static double Java . lang. Double .MIN_VALUE = Double . longBitsToDouble (OxOOOOOOOOOOOOOOOlL) 

public static final float Java . lang. Float .MAX_VALUE = 3 . 40282346638528860e+38f ; 



ETSI 



295 



ETSITS 101 812V1.3.1 (2003-06) 



Annex B (normative): Object carousel 
B.1 Introduction 

The broadcast applications are transmitted using the DSM-CC User-to-User Object Carousels. 
This specification is based on the following specifications: 

• ISO/IEC 13818-1 [23] - MPEG 2 systems 

• ISO/IEC 13818-6 [26] - DSM-CC 

• ETSI EN 301 192 [5] - DVB specification for data broadcasting 

• ETSI TR 101 202 [49] - Implementation Guidelines for Databroadcasting 
With the constraints and extensions described here. 

B.1.1 Key to notation 

Certain notations are used in the "value" columns of the syntax tables: 

Table B.1 : Key to notation 



Symbol 




+ 


A value that is "allocated" e.g. configuration parameter of the object 
carousel server. 


* 


A value that is "calculated" e.g. a field whose value is calculated by the 
carousel server as a consequence of the number of bytes in other fields 



B.2 Object Carousel Profile 



In the following chapter, the message structures of the Object carousels are introduced with associated additional 
restrictions. Each section contains a table specifying the restrictions on the usage of the fields. The table also indicates the 
source for these restrictions: the DSM-CC standard, DVB guidelines or a specific restriction for this specification. 

For the object carousel messages, also the message syntax is included. In the syntax tables grey shading indicates 
parts that the broadcaster may put in, but an MHP terminal compliant with this specification may ignore. 

B.2.1 DSM-CC Sections 

All object carousels messages are transmitted using DSM-CC section format. The DSM-CC Section format is defined in 
chapter 9.2 of the DSM-CC specification. 

The DSM-CC standard provides an option to use either a CRC32 or a checksum for detecting bit errors. For this 
specification, we make the following restriction: 

Table B.2 : Restrictions on DSIVI-CC Section format 



Field 


Restrictions 


Source 


section_syntax_indicator 


1 (indicating the use of the CRC32) 


This spec. 


last_section_number 


For sections transporting DownloadDataBlock fragments: 

- all modules intended to be retrieved shall have the last section 
number <= OxFE 

- if last section number = OxFF implementations conforming to this spec are 
allowed to abort the retrieval and report error condition 


This spec. 



The maximum section length is 4096 bytes for all types of sections used in Object Carousels. The section overhead is 12 
bytes, leaving a maximum of 4084 bytes of payload per section. 
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B.2.1 .1 Sections per TS packet 

Any single TS packet is allowed to contain no more than the payload of two sections (i.e. the end of one section and the 
beginning of another). 

B.2.2 Data Carousel 

This section defines the content of the data carousel messages when used in the object carousel. 

B.2.2. 1 General 

The definitions in Table B.3 apply to both the dsmccDownloadDataHeader and the similar dsmccMessageHeader. 
Table B.3 : Restrictions on DSIVI-CC DownloadData and IVIessage headers 



Field 


Restrictions 


Source 


Transaction Id 


See 'Assignment and use of transactionid 
values" on page 318 


This spec. 


AdaptationLength 


The MHP terminal may ignore the possible 
contents of the dsmccAdaptationHeader field. 


This spec. 



B.2.2.2 



Download! nfo I ndication 



The Downloadlnfolndication is a message that describes a set of modules and gives the necessary parameters to locate 
the module and retrieve it. 

Table B.4 : Restrictions on the DM 



Field 


Restrictions 


Source 


blockSize 


maximum size 4066 

(max. section payload - DDB-header size (18)) 

The recommended blockSize is 4066. 


DSM-CC 
(This spec, 
rec.) 


windowSize 


(not used for Object Carousels) 


DSM-CC 


ackPeriod 


(not used for Object Carousels) 


DSM-CC 


tCDownloadWindow 


(not used for Object Carousels) 


DSM-CC 


tCDownloadScenario 


(not used for Object Carousels) 


DSM-CC 


compatibilityDescriptor(): 
compatibilityDescriptorLe 
ngth 


(no compatibility descriptor for Object 
Carousels) 


DSM-CC 


PrivateDataLength 


The MHP terminal may ignore the possible 
contents of the privateData field 


DVB 



B.2.2.3 



DownloadServerlnitiate 



The DownloadServerlnitiate is used in the case of object carousels to provide the object reference to the ServiceGateway 
(i.e. root directory) of the object carousel. 

Table B.5 : Restrictions on DSI 



Field 


Restrictions 


Source 


compatibilityDescriptor(): 
compatibilityDescriptorLe 
ngth 


(no compatibility descriptor for Object 
Carousels) 


DSM-CC 


privateData 


Contains the ServiceGateway Info structure 


DSM-CC 


serverld 


Shall be set to 20 bytes each with the value of 
OxFF 


DVB / This 
spec. 
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B.2.2.4 



Modulelnfo 



The modulelnfo structure is placed in the modulelnfo field of the Downloadlnfolndication of the data carousel. It 
contains the information needed to locate the module. 

Table B.6 : Restrictions on the Dll modulelnfo field 



Field 


Restrictions 


Source 


BIOP::IVIodulelnfo::Taps 


The first tap shall have the "use" value 0x0017 (BIOP_OBJECT_USE). The 
id and selector fields are not used and the MHP terminal may ignore them. 
The MHP terminal may ignore possible other taps in the list. 


DVB 


BIOP::Modulelnfo:: 
Userlnfo 


The userlnfo field contains a loop of descriptors. These are specified in the 
DVB Data Broadcasting standard and/or this specification. The MHP 
terminal shall support the compressed_module_descriptor (tag 0x09) used 
to signal that the module is transmitted in compressed form. The userlnfo 
field may also contain a caching_priority_descriptor and one or more label_ 
descriptors. 


DVB / This 
spec. 



Table B.7 : BIOP::Modulelnfo syntax 



Syntax 


bits 


Type 


Value 


Comment 


BIOP: :ModuleInfo() { 
moduleTimeOut 
blockTimeOut 
minBlockTime 
taps_count 

{ 

id 

use 

assocTag 

select or_length 

} 


32 
32 
32 
8 

16 
16 
16 
8 


uimsbf 
uimsbf 
uimsbf 
uimsbf 

uimsbf 
uimsbf 
uimsbf 
uimsbf 


+ 
+ 
+ 
N1 

0x0000 
0x0017 
+ 
0x00 


>1 

user private 
BIOP_OBJECT_USE 


for {j=l; j<Nl; j++) { 

id 

use 

assocTag 

select or_length 

for (j=0; j<N2; j++) { 
selector_data 

} 
} 


16 
16 
16 
8 

8 


uimsbf 
uimsbf 
uimsbf 
uimsbf 

uimsbf 


+ 
+ 
+ 
N2 

+ 


Possible additional taps that 
may be ignored by MHP 
terminals. 


userinf oLength 
for (k=0; k<N3; j++) { 
userinf o_dat a 

} 
} 


8 
8 


uimsbf 
uimsbf 


N3 

+ 
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B.2.2.4.1 



Label descriptor 



The label_descriptor may be placed in the userlnfo field of the modulelnfo structure. It attaches a label to the 
corresponding module. Multiple labels can be attached to a module by including multiple label descriptors in the same 
userlnfo field. Labels can be used for pre-fetching modules (see 10.8.3.2, "Pre-fetch descriptor" on page 96). 

Within one object carousel, the same label may not be used in multiple DII messages. This implies that all modules that 
share a label are signalled in the same DII message. 

Table B.8 : Label descriptor syntax 



Syntax 


bits 


Type 


Value 


Comment 


label_descriptor ( ) { 










descriptor_tag 


8 


uimsbf 


0x70 




descriptor_length 


8 


uimsbf 


N1 




for (n=0; n<Nl; n++) { 










label_char 
} 
} 


8 


uimsbf 




The label 



descriptor_tag: This 8 bit integer value with 0x70 identifies this descriptor. 

Iabel_char: .These 8-bit fields carry an array of bytes that are a module label. This label matches a label used in one of 
the pre-fetch descriptors 10.8.3.2, "Pre-fetch descriptor" on page 96. 



B.2.2.4.2 



Caching priority descriptor 



To indicate priorities for the objects, a caching_priority_descriptor may be included in the userlnfo field of the 
modulelnfo in the Downloadlnfolndication message. 

This descriptor provides a priority value for the caching. The same priority applies for each object in the module. The 
priority indicated in the descriptor is only a hint to the MHP terminal and implementations may use that in combination 
with other caching strategies. 

The descriptor includes also the transparency level (see section B.5.2, "Transparency levels of caching" on page 326) that 
shall be used by the terminal implementation if it caches objects in this module. 

Table B.9 : Caching priority descriptor syntax 



Syntax 


bits 


Type 


Value 


Comment 












caching_priority_descriptor ( ) { 










descriptor_tag 


8 


uimsbf 


0x71 




descriptor_length 


8 


uimsbf 






priority_value 


8 


uimsbf 






transparency„level 

} 


8 


uimsbf 







descriptor_tag: This 8 bit integer value with 0x71 identifies this descriptor. 

priority_value: indicates the caching priority for the objects within this module. A higher value indicates more 
importance for caching. 
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transparency_level: Transparency level that shall be used by the MHP terminal if it caches objects contained in this 
module. The possible values are listed in table B.IO. The semantics of the policies are defined in section B.5.2, 
"Transparency levels of caching" on page 326. 





Table B.10 : Transparency level values 


Value 


Description 





reserved 


1 


Transparent caching 


2 


Semi-transparent caching 


3 


Static caching. 


4. ..255 


reserved for future use 



When this descriptor is not included in the userlnfo field of the modulelnfo for a module, the default values that shall be 
assumed are: 

• priori ty_value: 128 

• transparency_level: 1 (transparent caching) 

B.2.2.5 ServiceGatewaylnfo 

The ServiceGatewaylnfo structure is carried in the DownloadServerlnitiate message and provides the object reference to 
the ServiceGateway object. 

Table B.11 : Restrictions on the ServiceGatewaylnfo 



Field 


Restrictions 


Source 


BlOP:: 

ServiceGateway 1 nfo: : 
downloadTaps 


The MHP terminal may ignore the downloadTap list. 


This spec. 


BlOP:: 

ServiceGateway 1 nfo: : 
serviceContextList 


The IVIHP terminal may ignore the service context list. 


This spec. 


BlOP:: 

ServiceGateway 1 nfo: : 
Userlnfo 


The IVIHP terminal may ignore the user info. 


This spec. 



Table B.12 : ServiceGatewaylnfo() syntax (Sheet 1 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


ServiceGatewayInf o ( ) { 
lOP: :IOR() 
downloadTaps_count 


8 


uimsbf 


+ 
N1 


See Table B.21 on page 304 
software download Taps 


for (i=0; i<Nl; i++) { 

DSM: :Tap() 
} 










serviceContextList_count 


8 


uimsbf 


N2 


serviceContextList 


for (i=0; i<N2; i++) { 

context_id 

context_data_length 

for (j=0; j<N3; j++) { 
context_data_byte 

} 
} 


32 

16 

8 


uimsbf 
uimsbf 

uimsbf 


N3 

+ 




userlnfoLength 


16 


uimsbf 


N5 


user info 


for (i=0; i<N5; i++) { 
userinf o_data 


8 


uimsbf 


+ 
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Table B.12 : ServiceGatewaylnfo() syntax (Sheet 2 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


} 










} 











B.2.2.6 Download Cancel 

There is no semantic for this message in this profile. Receivers may ignore them. 

B.2.3 The Object Carousel 

B.2.3.1 BlOP Generic Object Message 

The BIOP Generic Object Message is a common structure used by all the BIOP (Broadcast Inter-ORB Protocol) 
messages. 

Table B.13 : Restrictions on the BIOP Generic Object Message 



Field 


Restrictions 


Source 


MessageHeader::byte_order 


(indicating big-endian byte order) 


DVB 


MessageSubHeader::objectKey 


Maximum iengtli of the key shall be four bytes. 


DVB 


MessageSubHeader::objectKind 


The short three-letter aliases shall be used, 
plus the null-terminator. 


DVB 


Access attributes 


Access attributes are not transmitted in object 
carousels 


DSM-CC 



B.2.3.2 



CORBA strings 



In a number of places Object Carousel messages include text strings. These are formatted in accordance with 12.3.2 of 
CORBA/IIOP [2] and using CDR-Lite encoding as specified by DSM-CC. I.e. the text is preceded by an integer 
specifying the length of the string and followed by a null terminator. The size of this integer depends on the string 
concerned and can be seen clearly in the syntax tables that follow. However, for clarity CORBA format strings and the 
size of their length fields are summarised in table B. 14: 

Table B.14 : Location of CORBA format strings 



string 


length 
field 
size 
(bits) 


location 


objectKind_data 


8 


Table B.16, "BIOP::FileMessage syntax," on page 301 


objectKind_data 

id_data 

kind_data 


32 
8 
8 


Table B.19, "BIOP::DirectoryMessage syntax," on page 303 


objectKind_data 


8 


Table B.28, "BIOP::StreamMessage syntax," on page 309 


objectKind_data 

eventName_ 

data 


32 
8 


Table B.30, "BIOP::StreamEventMessage syntax," on page 311 


type_id_byte 


32 


Table B.21, "IOP::IOR syntax," on page 304 


id_data 
kind_data 


32 
32 


Table B.25, "Syntax of Lite Options Profile Body with 
ServiceLocation component.," on page 307 
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B.2.3.3 



BlOP FileMessage 



The BIOP FileMessage is used for carrying file objects. 



Table B.I 5 : Restrictions on the BIOP File Message 



Field 


Restrictions 


Source 


MessageSubHeader: 
Objectlnfo 


The Objectlnfo may be empty (have a length of zero). If not empty the first 8 

bytes of the Objectlnfo shall contain the DSM::File::ContentSize attribute. 

This is optionally followed by a loop of descriptors. 

The descriptors defined for possible use in this location are: 

Content type descriptor 


This spec. 


MessageSubHeader:: 
ServiceContextList 


The MHP terminal may skip the possible serviceContextList structures. 


This spec. 



Table B.I 6 : BIOP::FileMessage syntax 



Syntax 


bits 


Type 


Value 


Comment 


BIOP: : FileMessage { 
magic 

biop_version.ma jor 
biop_version.minor 
byte_order 
message_type 
message_size 
ob jectKey_length 
for (i=0; i<Nl; i++) { 

ob jectKey_data 
} 

objectKind_length 
objectKind_data 
objectinf o_length 
DSM: :File: :ContentSize 
for (i=0; i<N2-8; i++) { 

descriptor ( ) 
} 
serviceContextList_count 


4x8 

8 

8 

8 

8 

32 

8 

8 

32 
4x8 
16 
64 

8 

8 


uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 

uimsbf 

uimsbf 
uimsbf 
uimsbf 
uimsbf 

uimsbf 

uimsbf 


0x42494F50 

0x01 

0x00 

0x00 

0x00 

* 

N1 

+ 

0x00000004 
0x66696000 
N2 

+ 

+ 
N3 


"BIOP" 

BIOP major version 1 
BIOP minor version 
Big endian byte ordering 

1..4 

"fil" type_id alias 
objectlnfo (note 1) 

serviceContextList 


for (i=0; i<N3; i++) { 

context_id 

context_data_length 

for (j=0; j<N4; j++) { 
cont ext_dat a_by t e 

} 
} 


32 
16 

8 


uimsbf 
uimsbf 

uimsbf 


N4 

+ 




messageBody_length 
content_length 
for (i=0; i<N5; i++) { 
content_byte 

} 
} 


32 
32 

8 


uimsbf 
uimsbf 

uimsbf 


* 
N5 

+ 


actual file content 


NOTE 1 : If present and non-zero, this shall be the same as the content_length of the referenced FileMessage. 
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B.2.3.4 



Content type descriptor 



Zero or one content type descriptors can be carried in the file MessageSubHeader : : Ob jectinf o or tlie BIOP : : 
Binding : : Ob jectinf o. Where more than one content type descriptor is used they shall express the same content 
format. Also, the content type (if any) signalled in the directory binding shall be identical to that signalled in the bound 
file's header. This optional descriptor identifies the media type of the file. 

This content type signalling only applies to objects of type file and is not appropriate for other object types. 

If this descriptor is absent or not sufficient to categorise the content type then the extension portion of the file name shall 
be used be used to provide the media type mapping via table 5, "File type identification" on page 59. The extension 
portion of the filename shall not be used if this descriptor is provided. 

The format of the content type descriptor is shown in table B.17. 

Table B.17 : Content type descriptor syntax 



Syntax 


bits 


Type 


Value 


Comment 


content_type_descriptor ( ) { 










descriptor_tag 


8 


uimsbf 


0x72 




descriptor_length 


8 


uimsbf 






for (i=0; i<descriptor_length; i++) { 










content_type_data_byte 

} 
} 


8 


uimsbf 




A MIME type 



descriptor_tag: This 8-bit integer with value 0x72 identifies this descriptor 

descriptor_length: This 8-bit integer identifies the number of bytes following it. 

content_type_data_byte: These bytes form a string that indicates the MIME content type of the object. The string is 
specified as follows: 

content_type_data = type "/" subtype *(";" parameter) 

Where type, subtype and parameter are as defined in section 5 of IETF RFC 2045 [64] and hence contenttype_ 
data carries the payload of the Content-Type header defined in [64]. 

B.2.3.5 BIOP DirectoryMessage 

The BIOP DirectoryMessage is used for carrying the directory objects. 

Table B.I 8 : Restrictions on the BIOP Directory Message 



Field 


Restrictions 


Source 


MessageSubHeader:: 
Objectlnfo 


The MHP terminal may sl<ip the N2 possible bytes in the objectlnfo field. 


This spec. 


MessageSubHeader:: 
ServiceContextList 


The MHP terminal may skip the N3 possible serviceContextList structures. 


This spec. 


BIOP::Name 


The name shall contain exactly one NameComponent. 


This spec. 


BIOP::Binding:: 
BindingType 


Either "ncontext" (in the case of a Directory object) or "nobject" (in the case 
of a File or a Stream object). Binding type "composite" shall not be used. 


DVB 


BIOP::Binding:: 
Objectlnfo 


The Objectlnfo for bound objects may be empty (have a length of zero). 

If the bound object is a file and the Objectlnfo is not empty the first 8 bytes 

of the Objectlnfo shall contain the ContentSize attribute. This is optionally 

followed by a loop of descriptors. 

The descriptors defined for possible use in this location are: 

Content type descriptor 


This spec. 
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Table B.19 : BIOP::DirectoryMessage syntax (Sheet 1 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


BIOP : :DirectoryMessage ( ) { 










magic 


4x8 


uimsbf 


0X42494F50 


"BIOP" 


biop_version .major 


8 


uimsbf 


0x01 


BIOP major version 1 


biop_version.minor 


8 


uimsbf 


0x00 


BIOP minor version 


byte_order 


8 


uimsbf 


0x00 


big endian byte ordering 


message_type 


8 


uimsbf 


0x00 




message_size 


32 


uimsbf 


* 




ob jectKey_length 


8 


uimsbf 


N1 


1..4 


for (i=0; i<Nl; i++) { 










objectKey_data 
} 
ob jectKind_length 


8 


uimsbf 


+ 




32 


uimsbf 


0x00000004 




objectKind_data 


4x8 


uimsbf 


0x64697200 


"dir" type_id alias 


objectinf o_length 


16 


uimsbf 


N2 = 

(note 1) 


objectlnfo 


for (i=0; i<N2; i++) { 










objectinf o_dat a 
} 


8 


uimsbf 


+ 




serviceContextList_count 


8 


uimsbf 


N3 


serviceContextList 


for (i=0; i<N3; i++) { 










context_id 


32 


uimsbf 






context_data_length 


16 


uimsbf 


N4 




for (j=0; j<N4; j++) { 










context_data_byte 
} 

} 


8 


uimsbf 


+ 




messageBody_length 


32 


uimsbf 


* 




bindings_count 


16 


uimsbf 


N5 




for (i=0; i<N5; i++) { 








Binding 


BIOP:: Name { 










nameComponents_count 


8 


uimsbf 


N6 = 1 


See Table B.I 5. 


for (i=0; i<N6; i++) { 










id_length 


8 


uimsbf 


N7 


NameComponent id 


for (j=0; j<N7; j++) ( 










id_data 
1 


8 


uimsbf 


+ 


The "/" character shall not be 
used. 


1 
kind_length 


8 


uimsbf 


N8 


NameComponent kind 


for (j=0; j<N8; j++) ( 










kind_data 

} 

1 


8 


uimsbf 


+ 


as type_id (see Table 4-4 in 
ETSITR101 202) 


} 

BindingType 


8 


uimsbf 


+ 


0x01 for nobject 
0x02 for ncontext 


lOP: :IOR() 






+ 


objectRef see Table B.21 on 
page 304 


objectinf o_length 


16 


uimsbf 


N9 




if(kind_data == "fil"){ 











ETSI 



304 



ETSITS 101 812V1.3.1 (2003-06) 



Table B.19 : BIOP::DirectoryMessage syntax (Sheet 2 of 2) 



Syntax 



bits 



Type 



Value 



Comment 



DSM: :File: :ContentSize 

for (j=0; j<N9-8; j++) 
descriptor_byte 



else { 

for (j=0; j<N9; j++) { 
descriptor_byte 



64 



uimsbf 



uimsbf 



means that file size is not 
signalled 



uimsbf 



NOTE 1 : See item 2 under 1 1 .3.2.2 "Directory Message Format" in DSM-CC "the objectlnfo field shall be empty". 



B.2.3.6 



BlOP ServiceGateway message 



The syntax of the BIOP ServiceGateway message is identical to that of the BIOP Directory Message (described above) 
with the following exceptions: 

• the object kind is "srg" rather than "dir". 

B.2.3.7 BIOP Interoperable Object References 

The Interoperable Object References (lOR) are references to objects and contain the necessary information to locate the 
object. The lOR structure may contain different options to be able to point to objects that can be reached via different 
types of connections. For this specification, the use of lORs is limited to references to objects carried in broadcast object 
carousels. For object carousels, there are two types of object references: one to be used to reference objects carried in the 
same object carousel and one to be used to reference objects in other object carousels. 

Table B.20 : Restrictions on the BIOP lOR 



Field 


Restrictions 


Source 


IOP::IOR::type_id 


Contains the objectKind of the referenced object. A short three-letter aliases 
shall be used, plus a null-terminator. 


This spec. 


IOP::IOR:: 
taggedProfileList 


There shall be at least 1 taggedProfile included in an lOR. For objects 

carried in a broadcast object carousel, the first taggedProfile shall be either 

a TAG_BIOP profile or a TAG_LITE_OPTIONS. 

If the first tagged profile is some 

other profile, the object is not carried in a 

broadcast object carousel and the M HP 

terminal may ignore the object subject to its own capabilities. 


This spec. 



Table B.21 : IOP::IOR syntax (Sheet 1 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


lOP: :IOR { 










type_id_length 


32 


uimsbf 


N1 




for (i=0; i<Nl; i++) { 










type_id_byte 

1 


8 


uimsbf 


+ 


Short alias type_id (e.g. "dir") 


taggedProf iles_count 


32 


uimsbf 


N2 


Profile bodies 
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Table B.21 : IOP::IOR syntax (Sheet 2 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


lOP : :taggedProf ile () 








For objects in broadcast 
carousels: either 
BIOPProfileBody or 
LiteOptionsProfileBody. 


for (n=0; n<N2-l;n++) { 
lOP : :taggedProf ile () 
} 








MHP terminal may ignore 
other profiles (2...N1) if 
present 


} 











B.2.3.7.1 



BIOPProfileBody 



The BiopProfileBody is used for references to objects within the same object carousel. 

Table B.22 : Restrictions on the BlOP Profile Body 



Field 


Restrictions 


Source 


BiopProfileBody: :byte_ 
order 


(indicating big-endian byte order) 


DVB 


BiopProfileBody:: 
LiteComponent 


The list shall contain exactly 1 BiopObjectLocation and exactly 1 DSM:: 
ConnBinder as the first two components in that order. The MHP terminal 
may ignore possible other components in the list. 


This spec. 


DSM::ConnBinder 


For objects carried in the broadcast object carousel, the first Tap shall be of 
type BIOP_DELIVERY_PARA_USE. If there is another type of tap in the 
first position, the MHP terminal may ignore this object reference, as it is a 
reference for object accessed using another type of protocol (e.g. for return 
channel use). The MHP terminal may ignore possible other taps in the list. 


This spec. 


DSM::Tap 


In the BIOP_DELIVER_PARA_USE tap, the id field is not used and may be 
ignored by the MHP terminal. 


This spec. 



Table B.23 : BlOP Profile Body syntax (Sheet 1 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


BIOPProfileBody { 










prof ileld_tag 


32 


uimsbf 


0x49534F06 


TAG_BIOP (BlOP Profile 
Body) 


prof ile_data_length 


32 


uimsbf 


* 




prof ile_data_byte_order 


8 


uimsbf 


0x00 


big endian byte order 


lite_component_count 


8 


uimsbf 


N1 




BlOP : :ObjectLocation { 










component I d_tag 


32 


uimsbf 


0x49534F50 


TAG_ObjectLocation 


component_data_length 


8 


uimsbf 


* 




carouselld 


32 


uimsbf 


+ 




moduleld 


16 


uimsbf 


+ 




version .major 


8 


uimsbf 


0x01 


BlOP protocol major version 1 


version. minor 


8 


uimsbf 


0x00 


BlOP protocol minor version 


ob jectKey_length 


8 


uimsbf 


N2 


1..4 


for (k=0; k<N2; k++) { 










objectKey_data 
} 
} 


8 


uimsbf 


+ 
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Table B.23 : BlOP Profile Body syntax (Sheet 2 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


DSM: :ConnBinder { 










component I d_tag 


32 


uimsbf 


0x49534F40 


TAG_ConnBinder 


component_data_length 


8 


uimsbf 


N4 




taps_count 


8 


uimsbf 


N3 




DSM: :Tap { 










id 


16 


uimsbf 


0x0000 


user private 


use 








If BIOP_DELIVERY_PARA_ 




16 


uimsbf 


0x0016 


USE is provided it shall be the 
first tap. 

If there is another type of tap in 
the first position, the MHP 
terminal may ignore this object 
reference, as it is a reference 
for an object accessed using 
another type of protocol (e.g. 
for return channel use). 


assocTag 


16 


uimsbf 


+ 




select or_length 


8 


uimsbf 


OxOA 




selector_type 


16 


uimsbf 


0x0001 




transactionid 


32 


uimsbf 


* 




timeout 

} 


32 


uimsbf 


* 




for (n=0; n<N4-18; n++) { 








The MHP terminal may skip 
over the possible additional 
taps 


additional_tap_byte 

} 


8 


uimsbf 






} 

for (n=0;n<N6;n++) { 








N6=N1-2 


BIOP : : LiteComponent { 










component Id_tag 


32 


uimsbf 


+ 




component_data_length 


8 


uimsbf 


N7 




for (i=0; i<N7; i++) { 










component_data_byte 
} 
} 
} 


8 


uimsbf 






} 











ETSI 



307 



ETSITS 101 812V1.3.1 (2003-06) 



B.2.3.7.2 



LiteOptionsProfileBody 



The LiteOptionsProfileBody is used for making links to objects carried in other object carousels. The 
LiteOptionsProfileBody can be used to make references to objects carried in other carousels within the same Transport 
Streams or in other Transport Streams. The following constraints are put on the use of the LiteOptionsProfileBody; 

• LiteOptionsProfileBody references shall never be used in an lOR which is in the DSI referencing the service 
gateway. 

• The target carousel is never mounted automatically by the implementation, but the application may do so using 
the MHP DSMCC API and where necessary, the tuning API. 

• When the LiteOptionsProfileBody is encountered the application will get a ServiceXFRErrorEvent or a 
ServiceXFRException unless the object carousel which is the target of the lite options profile body reference is 
already mounted by the MHP terminal. In this latter case, the access to the object shall succeed unless the object 
is unavailable, e.g. the target file does not exist in the target carousel or the target carousel has lost its connection. 

Table B.24 : Restrictions on the Lite Options Profile Body 



Field 


Restrictions 


Source 


LiteOptionsProfileBody:: 
profile_data_byte_order 


(indicating big-endian byte order) 


DVB 


LiteOptionsProfileBody:: 
LiteOptionComponents 


The list shall contain a ServiceLocation component as the first component. 
The MHP terminal may ignore possible other components in the list. 


This spec. 


DSM : ;ServiceLocation 


For objects carried in the broadcast object carousel, the service domain 
NSAP address shall follow the Carousel NSAP address format. 


This spec. 


DSM::ServiceLocation:: 
InitialContext 


The MHP terminal may ignore the initial context 


This spec. 



Table B.25 : Syntax of Lite Options Profile Body with ServiceLocation component. (Sheet 1 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


LiteOptionsProfileBody { 










prof ileld_tag 


32 


uimsbf 


0x49534F05 


TAG_LITE_OPTIONS (Lite 
Options Profile Body) 


prof ile_data_length 


32 


uimsbf 


* 




prof ile_data_byte_order 


8 


uimsbf 


0x00 


big endian byte order 


lite_component_count 


8 


uimsbf 


N1 




DSM: : ServiceLocation { 










componentId_tag 


32 


uimsbf 


0x49534F46 


TAG_ServiceLocation 


component_data_length 


8 


uimsbf 


♦ 




serviceDomain_length 


8 


uimsbf 


0x14 


Length of carousel NSAP 
address 


serviceDomain_data ( ) 


160 


uimsbf 


+ 


Table B.26 "DVB Carousel 
NSAP Address" 


CosNaming: :Name ( ) { 








pathName 


nameComponents_count 


32 


uimsbf 


N2 




for (i=0; i<N2; i++) { 










id_length 


32 


uimsbf 


N3 


NameComponent id 


for (j=0; j<N3 j++) ( 










id_data 


8 


uimsbf 


+ 




kind_length 


32 


uimsbf 


N4 


NameComponent kind 


for (j=0; j<N4 j++) { 










kind_data 

} 

} 


8 


uimsbf 


+ 


as type_id (see Table 4-4 in 
ETSITR101 202) 
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Table B.25 : Syntax of Lite Options Profile Body with ServiceLocation component. (Sheet 2 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


} 

initialContext_length 


32 


uimsbf 


N5 




for (n=0; n<N5 n++) { 

InitialContext_data_byte 
} 


8 


uimsbf 






} 










for (n=0;n<N6;n++) { 

BIOP : : LiteComponent { 
component Id_tag 
component_data_length 
for (i=0; i<N7; i++) { 
component_data_byte 
} 
} 
} 


32 
8 

8 


uimsbf 
uimsbf 

uimsbf 


+ 
N7 


N6=N1-1 


} 











Table B.26 : DVB Carousel NSAP Address 



Syntax 


bits 


Type 


Value 


Comment 


DVBcarouselNSAPaddress { 










AFI 


8 


uimsbf 


0x00 


NSAP for private use 


Type 


8 


uimsbf 


0x00 


Object carousel NSAP Address. 


carouselld 








To resolve this reference a carousel_ 
id_descriptor with the same carousel_ 




32 


uimsbf 


+ 


id as indicated in this field must be 
present in the PMT signalling for the 
service identified below. 


specif ierType 


8 


uimsbf 


0x01 


IEEE OUI 


specifierData { IEEE OUI } 


24 


uimsbf 


0x0001 5A 


Constant for DVB OUI 


dvb_service_location () { 










transport_stream_id 








This may be set to 0x0000 which 
indicates that the MHP terminal shall 




16 


uimsbf 


+ 


not use the transport_stream_id when 
locating the service. For any other 
value then this field shall be used. 


original_network_id 


16 


uimsbf 


+ 




service_id 


16 


uimsbf 


+ 


(= MPEG-2 program_number) 


reserved 
} 
} 


32 


bslbf 


OxFFFFFFFF 
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B.2.3.8 BlOP Stream Message 

Table B.27 : Restrictions on the BlOP Stream IVIessage 



Field 


Restrictions 


Source 


MessageSubHeader:: 
Objectlnfo 


The Objectlnfo field contains the DSM::Stream::lnfo_T structure and 
optionally other data after the Stream Info structure. MHP terminals may 
Ignore the aDescription_bytes In the DSM::Stream::lnfo_T structure and the 
possible other object info data following the structure. Broadcasts may set 
the duration field to zero to indicate undefined duration. 


This spec. 


MessageSubHeader:: 
ServiceContextList 


The MHP terminal may skip the possible serviceContextList structures. 


This spec. 


MessageSubHeader:: 
MessageBody 


The MessageBody carries a sequence of taps. 

There shall be at most one tap of use BIOP_PROGRAM_USE. This tap 

Identifies the service that provides the media stream associated with the 

Stream object (via a deferred_associatlon_tags_descrlptor in the PMT).The 

tap may only reference programs that are broadcast on the same multiplex 

(i.e. MHP terminals shall not need to tune to a different multiplex in order to 

receive the referenced media stream). 

There shall also be at most one tap with use STR_NPT_USE, which MHP 

terminals shall Interpret as described in ISO/IEC 13818-6 [26]. 

MHP terminals may ignore possible other Taps (such as BIOP_ES_USE). 


This spec. 



Table B.28 : BIOP::StreamMessage syntax (Sheet 1 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


BIOP: :StreamMessage() { 
magic 

biop_version .major 
biop_version.minor 
byte_order 
message_type 
message_size 
objectKey_length 
for (i=0; i<Nl; i++) { 

ob jectKey_data 
} 

ob jectKind_length 
ob jectKind_data 
ob jectinf o_length 
DSM: : Stream: :Info_T { 

aDescription_length 


4x8 

8 

8 

8 

8 

32 

8 

8 

32 

8 

16 

8 


uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 

uimsbf 

uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 


0X42494F50 

0x01 

0x00 

0x00 

0x00 

* 

N1 

+ 

0x00000004 
0x73747200 
N2 

N3 


"BlOP" 

BlOP major version 1 
BlOP minor version 
big endian byte ordering 

1..4 

"str" type_ld alias 

objectlnfo 
aDescrlption 


for (i=0; i<N3; i++) { 

aDescription_bytes 
} 


8 


uimsbf 


+ 




duration . aSeconds 

duration. aMicroSeconds 

audio 
video 
data 

} 


32 

32 

8 
8 
8 


simsbf 

uimsbf 

uimsbf 
uimsbf 
uimsbf 


+ 

+ 

+ 
+ 
+ 


may be set to to Indicate 

undefined 

may be set to to indicate 

undefined 


for (i=0; i<N2- (N3+10) ; i++) { 

objectinf o_byte 
} 


8 


uimsbf 


+ 




serviceContextList_count 


8 


uimsbf 


N4 


serviceContextList 
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Table B.28 : BIOP::StreamMessage syntax (Sheet 2 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


for (i=0; i<N4; i++) { 

context_id 

context_data_length 

for (j=0; j<N5; j++) { 
context_data_byte 

} 
} 


32 

16 

8 


uimsbf 
uimsbf 

uimsbf 


N5 

+ 




messageBody_length 

taps_count 

for (i=0; i<N6; i++) { 

id 

use 

assocTag 
select or_length 
} 
} 


32 
8 

16 

16 

16 
8 


uimsbf 
uimsbf 

uimsbf 

uimsbf 

uimsbf 
uimsbf 


N6 

(note 1) 

+ 

+ 
0x00 


see B.2.4.4 "Timebases" 
see Table 4-12 in DVB 
Guidelines for Data 
Broadcasting 

no selector 


NOTE 1 : If the tap use is STR_NPT_USE then the value of this 1 6 bit integer corresponds to the value of the 

contentid field of the NPTReferenceDescriptor that defines the time base for this stream. For other values of 
tap use the value of this field is undefined. 
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B.2.3.9 BlOP Stream EventMessage 

Table B.29 : Restrictions on tlie BlOP StreamEvent Message 



Field 


Restrictions 


Source 


MessageSubHeader: 
Objectlnfo 


The Objectlnfo field contains the DSM::Stream::lnfo_T and DSM::Stream:: 

EventList_T structures followed optionally by other object info data (which 

may be ignored by MHP terminals). 

See Table B.27 on page 309 regarding the DSM::Stream::lnfo_T. MHP 

terminals may ignore the possible other data following the DSM::Stream:: 

EventList_T. 

The EventList_T defines a sequence of event names that correlates to the 

sequence of event ids in the MessageBody. eventNames_count shall equal 

eventlds_count. 


This spec. 


MessageSubHeader:: 
ServiceContextList 


The MHP terminal may skip the possible serviceContextList structures. 


This spec. 


MessageSubHeader: 
MessageBody 


The MessageBody carries a sequence of taps followed by a sequence of 

event ids. 

The sequence of taps follows the following rules: 

• There shall be at most one tap of use BIOP_PROGRAM_USE. This tap 
identifies the service that provides the media stream associated with the 
Stream object (via a deferred_association_tags_descriptor in the PMT).The 
tap may only reference programs that are broadcast on the same multiplex 
(i.e. MHP terminals shall not need to tune to a different multiplex in order to 
receive the referenced media stream). 

• There shall be at most one tap with use STR_NPT_USE, which MHP 
terminals shall interpret as described in ISO/IEC 13818-6 [26]. 

• There shall be at most one tap with use STR_EVENT_USE or STR_ 
STATUS_AND_EVENT_USE.This tap indicates the PID where all 
StreamEvent descriptors related to the StreamEvent object are broadcast. 
MHP terminals may ignore possible other Taps (such as BIOP_ES_USE). 


This spec. 



Table B.30 : BIOP::StreamEventMessage syntax (Sheet 1 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


BIOP : :StreamEventMessage { 
magic 

biop_version.ma jor 
biop_version.minor 
byte_order 
message_type 
message_size 
ob jectKey_length 
for (i=0; i<Nl; i++) { 

ob jectKey_data 
} 

ob jectKind_length 
ob jectKind_data 
objectinf o_length 
DSM: : Stream: :Info_T { 

aDescription_length 


4x8 

8 

8 

8 

8 

32 

8 

8 

32 
4x8 

16 

8 


uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 

uimsbf 

uimsbf 
uimsbf 
uimsbf 
uimsbf 
uimsbf 


0X42494F50 

0x01 

0x00 

0x00 

0x00 

* 

N1 

+ 

0x00000004 
0x73746500 
N2 

N3 


"BlOP" 

BlOP major version 1 
BlOP minor version 
big endian byte ordering 

"ste" type_id alias 
aDescription 


for (i=0; i<N3; i++) { 

aDescription_bytes 
} 


8 


uimsbf 


+ 


see BlOP StreamMessage 


duration . aSeconds 
duration . aMicroSeconds 
audio 
video 


32 
32 
8 
8 


simsbf 
uimsbf 
uimsbf 
uimsbf 


+ 
+ 
+ 
+ 


see BlOP StreamMessage 
see BlOP StreamMessage 
see BlOP StreamMessage 
see BlOP StreamMessage 
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Table B.30 : BIOP::StreamEventMessage syntax (Sheet 2 of 2) 



Syntax 


bits 


Type 


Value 


Comment 


data 


8 


uimsbf 


+ 


see BlOP StreamMessage 


1 

DSM: :Event : :EventList_T { 










event Name s_count 


16 


uimsbf 


N4 




for (i=0; i<N4; i++) { 










eventName_length 


8 


uimsbf 


N5 




for (j=0; j<N5; j++) { 










eventName_data 
} 
} 
} 


8 


uimsbf 


+ 


(including zero terminator) 


for (i=0; i<N2 - (N3 + 14 + N4 + sum(N5)); i++ 


) { 






objectinf o_byte 
} 


8 


uimsbf 


+ 




serviceContextList_count 


8 


uimsbf 


N6 




for (i=0; i<N6; i++) { 










context_id 


32 


uimsbf 






context_data_length 


16 


uimsbf 


N7 




for (j=0; j<N7; j++) { 










context_data_byte 
} 
} 


8 


uimsbf 


+ 




messageBody_length 


32 


uimsbf 


* 




taps_count 


8 


uimsbf 


N8 




for (i=0; i<N8; i++) { 










id 


16 


uimsbf 


(note 1) 


see B.2.4.4 "Timebases" 


use 








see Table 4-12 in DVB 




16 


uimsbf 


+ 


Guidelines for Data 
Broadcasting 


assocTag 


16 


uimsbf 


+ 




select or_length 

1 


8 


uimsbf 


0x00 


no selector 


eventIds_count 


8 


uimsbf 


N4 


(= eventNames_count) 


for (1=0; 1<N4; 1++) { 










eventid 
} 
} 


16 


uimsbf 


+ 




NOTE 1 : If the tap use is STR_NPT_USE ttien the value c 


)fthis 16 b 


t integer corresponds to the value of the 


contentid field of the NPTReferenceDescriptorth 


at defines 


the time base for this stream. For other values of 


tap use the value of this field is undefined. 







B.2.4 Stream Events 

There are two versions of stream messages. The BIOP StreamMessage is used for carrying the stream objects that don't 
use DSM-CC Stream events. The BIOP StreamEventMessage is used for carrying stream objects that include a stream 
carrying the DSM-CC Stream events. This section addresses the later. 

B.2.4. 1 Stream & StreamEvent messages 

B.2.4.1 .1 Association witii time bases 

The id field of the STR_NPT_USE tap of a StreamMessage or StreamEventMessage identifies the timebase associated 
with that Stream/StreamEvent object. Multiple StreamMessage or StreamEventMessage may be used at the same time to 
allow subscriptions to multiple timebases of the same service. See B.2.4.4, "Timebases" on page 316. 
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B.2.4.1 .2 Event names and event ids 

In StreamEventMessages the EventList_T defines a sequence of event names that correlates 1:1 to the sequence of event 
ids in the MessageBody. Within each BIOP::StreamEventMessage the event names uniquely associate to event id values. 

• The eventNames_count shall equal eventIds_count. 

• The names in the EventList_T are zero -terminated strings. 

• The eventID values in the StreamEventMessage correspond to the eventID values carried in 
StreamEventDescriptors. 

B.2.4.1. 3 Stream event life time 

In StreamEventMessages the set of events described in the BIOP::StreamEvent message is possibly a subset of the events 
that may be used by the application during the course of a programme. Therefore, applications may need to 
accommodate the dynamic change of such messages. Cache transparency (see section B.5.2.1, "Transparent caching" on 
page 326) and version listener mechanisms (see DSMCCObject methods in annex P, "(normative): Broadcast Transport 
Protocol Access" on page 549) provide applications with the means to do this. 

Similarly the set of stream event descriptors being transmitted at any time may not correspond to the set of events 
described in the BIOP::StreamEventMessage. 

The event id for an event name shall not change while the name exists. If a name is removed it shall not be reintroduced 
within 60 seconds. 

B.2.4.2 Stream Descriptors 

B.2.4.2.1 NPT Reference descriptor 

B.2.4.2. 1.1 Usage scenarios 

The following 3 usage scenarios are envisaged for NPT: 

• No NPT associated with a service 

Enables use of "do it now" events but not scheduled events 

• A single continuous timebase (i.e. a single progressing value of NPT) 

In this case all types of stream event can be used. However, the broadcast is logically a single continuing 
interactive production and the broadcaster is responsible for preprocessing the applications etc. before broadcast 
to be suitable 

• The signal received by the MHP terminal includes a unique timebase for each programme needing one. This 
timebase to be suspended during any insertion into that programme and this timebase to be discontinued at the 
end of the programme. 

i.e. the timebase for each programme is preserved through the distribution network. 

B.2.4.2. 1.2 Syntax 

MHP terminals shall interpret this descriptor as it is described in ISO/IEC 13818-6 [26] with the following clarifications 
and additions. 

With regard to contentid: 

• This 7 bit field identifies the "timebase" see B.2.4.4, "Timebases" on page 316. 
With regard to scaleNumerator and scaleDenominator: 

1/1 - means normal play. 

i.e. NPT and STC advance at the same rate. 

• 0/m (m > 0) - means the NPT value does not advance. 
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As a consequence no scheduled stream events will be raised. However, the "do it now" events continue to be 
effective. 

• 0/0 - means that the scaleNumerator and scaleDenominator fields are not defined in the NPT Reference descriptor 
and should be derived as described in ISO/IEC 13818-6 [26] "8.1.2 Reconstruction of NPT" 

MHP terminals are not required to support this mode of operation. 

• m/0 (m > 0) - this is not allowed by ISO/IEC 1 3 8 1 8-6 [26] . 

With regard to broadcast repetition rate: 

• NPT Reference descriptors shall be transmitted at least once per second. 
With regard to postDiscontinuity indicator: 

• it is optional for broadcasters to broadcast descriptors with this set to one however if they are broadcast then the 
following conditions shall be met 

• it shall be broadcast for at least 5 seconds before the underlying PCR discontinuity 

• the descriptors with both states of postDiscontinuity indicator shall be carried within the same DSMCC 
descriptor list section 

• within one second of the underlying PCR discontinuity, the NPTReferenceDescriptor must be updated to reflect 
the new underlying PCR. See org . dvb . dsmcc . NPTDiscontinuityEvent in annex P, "(normative): 
Broadcast Transport Protocol Access" on page 549. 

• it is optional for MHP terminals to take advantage of this signalling but terminals which do not take advantage of 
this must ignore descriptors with postDiscontinuity indicator set to 1 . 

B.2.4.2.2 Stream event descriptor 

B. 2.4.2. 2.1 Association of event ids to event time 

The eventNPT field conveys the NPT value at which the event will occur (or has occurred). 

Each StreamEventDescriptor provides a single association between an eventID and a value of eventNPT. If the MHP 
terminal detects a change in the value of eventNPT associated with a value of eventID this redefines the time at which the 
event should fire. 

MHP terminals shall ignore scheduled events where the eventNPT has passed. 

See also "number range for NPT" on page 315 and "Signalling of "do it now events"" on page 3 14. 

B.2.4.2.2.2 Re-use of event ids 

Event ID values may be re-used any number of times. For example, after an event has fired then stream event descriptors 
with the same eventID but different eventNPT may be broadcast. 

B.2.4.2.2. 3 Signalling of "do it now events" 

ISO/IEC 13818-6 [26] is silent on the broadcast signalling of "do it now" events. 

These events shall be identified by the value of eventID and hence table id extension (see "Encoding of table id 
extension" on page 315). 

Where the value of eventID identifies a "do it now" event then the value of eventNPT shall be ignored by the MHP 
terminal. 

B.2.4.2.2.4 Private data 

The privateDataByte field does not need to be interpreted by the MHP terminal. 

NOTE: that an application can access the privateDataByte field via 1 1.4.2.5, "Extensions to the 

Framework" on page 117 and 11.5.1, "Broadcast Transport Protocol Access API" on page 123 
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B.2.4.2.3 Unused descriptors 

MHP terminals may ignore the following descriptors if present: 

• NPT Endpoint descriptor 

• Stream Mode descriptor 

B.2.4.2.4 Clarification of number encoding 

B. 2.4.2. 4.1 number range for NPT 

There is some ambiguity in ISO/IEC 13818-6 [26] regarding the data type used to carry NPT values in the signalling 
(tcimsbf or uimsbf). The following requirements insulate this profile from this ambiguity: 

• The range of values used shall be in the range to OxOFFFFFFFF (which is unambiguous for both tcimsbf or 
uimsbf). 



B.2.4.2.4.2 



number range for scaleDenominator 



There is some ambiguity in ISO/IEC 13818-6 [26] regarding the data type used to carry scaleDenominator values 
in the signalling (tcimsbf or uimsbf). The following requirements insulate this profile from this ambiguity: 

• The range of values used shall be in the range to 0x7FFF (which is unambiguous for both tcimsbf or uimsbf). 

B.2.4.3 DSM-CC Sections carrying Stream Descriptors 

B.2.4.3.1 Section version number 

The section version number field increments to reflect changes in stream descriptor(s) carried by sections with the same 
value of table_id (0x3 D) and table_id_extension. 

The version number shall increment for reasons including the change in value of eventNPT for a given eventld. 

B.2.4.3.2 Single firing of "do it now" events 

MHP terminals shall respond to the first instance of a "do it now" event detected under a particular combination of table 
id, table id extension & version number. Reception of subsequent copies of the particular event shall be ignored until a 
different version number is detected. 

B.2.4.3.3 Section number 

For this specification MHP terminals shall only consider section number zero. 

B.2.4.3.4 DSM-CC sections for DSMCC_descriptor_list() 

If the table_id field equals Ox3D the current_next_indicator bit shall be set to "1". 

B.2.4.3. 5 Encoding of table id extension 

The section's table id extension field provides information on the stream descriptor(s) carried by the section: 
Table B.31 : Encoding of table id extension for DSMCC_descriptor_lists 



table_id_extension bits 


Payload of DSM-CC section with table ID 0x3D 


[15] 


[14] 


[13...0] 








eventlD[13...0] 


Section carries a single "do it now" event 





1 


XX xxxx xxxx 


Section carries NPT reference descriptors 


1 





XX xxxx xxxx 


Section carries one or more other stream descriptors. I.e 

- Stream event descriptor(s) with a future eventNPTs 

- Stream mode descriptor (can be ignored in this specification) 

- NPT endpoint descriptor (can be ignored in this specification) 


1 


1 


reserved for future use 
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The value of eventID for "do it now" events shall be in the range 0x0001 . . .Ox3FFF. The value of eventID for scheduled 
events shall be in the range 0x8000... OxBFFF. The value is not allowed (see 5.5.2.2.1 in ISO/IEC 13818-6 [26]). 

B.2.4.4 Timebases 

Multiple concurrent timebases may be defined for a single MPEG program but only a single time base is allowed to 
progress at any instant (the other timebases shall be paused). The relationship between each timebase and the MPEG 
timebase (STC) is defined by an NPTReferenceDescriptor. The contentid field of the NPTReferenceDescriptor (a 7 bit 
unsigned integer) identifies the timebase. 

The value of the id field of the STR_NPT_USE tap (a 16 bit unsigned integer) of a StreamMessage or 
StreamEventMessage identifies the timebase associated with that Stream/StreamEvent object. Multiple StreamMessage 
or StreamEventMessage may be used at the same time to allow subscriptions to multiple timebases of the same service. 

In this profile NPTReferenceDescriptors can indicate two states: 

• non-paused 

The scaleNumerator and scaleDenominator are both non-zero 

• paused 

The scaleNumerator is zero and the scaleDenominator is non-zero 

When a timebase is signalled as paused then the NPT value for that timebase is frozen at NPT_Reference (as specified by 
equation 8-4 in DSM-CC). 

All of the NPTReferenceDescriptors for all of the currently signalled timebases shall be carried in a single DSMCC_ 
descriptor_list section and shall be transmitted at least once every second. In any such set of NPTReferenceDescriptors at 
most one shall be non-paused and there shall be at most one instance of each value of contentid. The set of signalled 
timebases can change through time. When a timebase is not signalled then the behaviour of the MHP terminal shall be 
identical to that of the timebase being paused. 

Timebases can be added or subtracted from the current set. The set of current timebases can be empty. 

A stream (i.e. a StreamMessage or StreamEventMessage) may have no associated timebase (i.e. it may have no tap with 
use STR_NPT_USE). This is valid in the following cases: 

• only "do it now" events are used 

• no stream events are used 

A value of contentid shall not be reused for a new timebase within 60 seconds of the removal of the timebase. 

In normal use the NPT of a non-paused timebase progresses at a constant rate. Discontinuities should either be the results 
of errors in the broadcast or transient conditions (for example, while an NPT reference generator catches up with an 
MPEG PCR discontinuity). Transient discontinuities should be tolerated by the MHP Terminal. The behaviour of the 
MHP terminal when subject to a permanent discontinuity is not specified, apart from the generation of the 
NPTDiscontinuityEvent to registered listeners. 

The broadcaster shall start generating corrected NPTReferenceDescriptors within at most 1 second of a PCR 
discontinuity (ideally the descriptors should be generated before the PCR discontinuity). If the receiver is sampling the 
NPTReferenceDescriptor at the lowest allowed rate (once every 5 seconds) then the receiver may not receive a correct 
NPTReferenceDescriptor for 5 seconds. During this period the receiver should linearly extrapolate the NPT from 
previous NPT values in the expectation that a corrected NPTReferenceDescriptor will be delivered shortly. See also B.2. 
4.2.1.2, "Syntax" on page 313 on use of the postDiscontinuity. 

There is a window of uncertainty around a segment of paused timebase due to the time taken for all receivers to acquire 
the new NPTReferenceDescriptor. During this window scheduled events cannot be used reliably. 

NOTE: It is suggested that broadcasters use "do it now" events near junctions between different timebases. 
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B.2.4.5 Monitoring stream events 

B.2.4.5.1 NPT reference monitoring 

When applications have registered for timebase stimulated events, the MHP terminal shall allocate resources sufificient to 
ensure that updates to the set of timebases is detected within 5 seconds for conformant broadcasts. 

B.2.4.5. 2 Timebase stimulated event monitoring 

When applications have registered for timebase stimulated events the MHP terminal shall allocate resources sufficient to 
ensure that updates to the set of timebase stimulated events is detected within 5 seconds for conformant broadcasts. So, if 
an event is introduced or the NPT time at which it is specified to fire is changed then the MHP terminal will respect this 
change within 5 seconds. If the fire time for an event changes less than 5 seconds before it was previously scheduled to 
fire then there is no guarantee that all receivers will detect the change in time. 

If a timebase is deleted (reference to it is removed from the set of NPTReferenceDescriptors) then the receiver shall 
deactivate any event listeners dependant on that timebase and may free resources associated with those listeners. 

B.2.4.5.3 "do it now" events 

"do it now" events are single shot events, accordingly MHP terminals need to make special efforts to ensure a high 
probability that they can be reliably received. 

For each application, the MHP terminal is not required to monitor more than a single component delivering "do it now" 
stream events. So, if events from more than one DSM-CC StreamEventMessage are subscribed to no more than one 
stream component shall be specified as the source of StreamEventDescriptors carrying "do it now" events (i.e. the taps 
with use STR_EVENTUSE or STR_STATUS_AND_EVENT_USE shall have the same value when referring to "do it 

now" events). 

MHP terminals shall dedicate a section filter to monitoring the possible transmission of "do it now" events while there are 
any applications subscribed to these events. 

B.2.4.5. 4 sciieduled events 

The stream descriptors for scheduled events are transmitted several times in the period before the time that they should 
fire. This allows a high probability that they will be effective even if they are not monitored continuously by the MHP 
terminal. 

Any scheduled stream event descriptors shall be transmitted at least once each second. 

MHP terminals shall raise an event in response to a scheduled stream event provided that the stream event descriptors are 
broadcast for at least 5 seconds before the scheduled time. 

For each application, the MHP terminal is not required to monitor more than a single component delivering scheduled 
stream events. So, if events from more than one DSM-CC StreamEventMessage are subscribed to no more than one 
stream component shall be specified as the source of StreamEventDescriptors carrying scheduled events (i.e. the taps 
with use STR_EVENT_USE or STR_STATUS_AND_EVENT_USE shall have the same value when referring to 
scheduled events). 

NOTE: Scheduled and "do-it-now" stream events can be carried on different stream components. The MHP 
terminal is required to be able to monitor one stream of each. 

B.2.4.5. 5 number of NPT components 

The MHP terminal is only required to monitor a single NPT component. So, if events from more than one DSM-CC 
StreamEventMessages are subscribed to no more than one stream component shall be specified as the source of 
NPTReferenceDescriptors (i.e. the taps with use STR_NPT_USE shall be the same). 
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B.2.5 Assignment and use of transaction Id values 
B.2.6 Informative Background 

The use of the transactionid in the object carousel is inherited from its use as defined by the DSM-CC specification, and 
as such it can appear somewhat complex. The transactionid has a dual role, providing both identification and versioning 
mechanisms for control messages, i.e. Downloadlnfolndication and DownloadServerlnitiate messages. The transactionid 
should uniquely identify a download control message within a data carousel, however it should be "incremented" 
whenever any field of the message is modified. 

NOTE: The term "incremented" is used in the DSM-CC specification. Within the scope of this specification 
this should be interpreted as "changed". 

The object carousel is carried on top of one or more data carousels. By a data carousel used below the object carousel, we 
mean in this specification a set of Downloadlnfolndication message transmitted on a single PID and the 
DownloadDataBlock messages carrying the modules described in the Downloadlnfolndication messages. The 
DownloadDataBlock messages may be spread on other elementary streams than the Downloadlnfolndication messages. 
The DownloadServerlnitiate message in the context of object carousels is considered to be part of the top level of the 
object carousel and not associated with any data carousel. 

When a module is changed, the version number of the module needs to be changed. This implies that the 
Downloadlnfolndication message that references the module needs to be also updated. Since the 
Downloadlnfolndication is updated, the transactionid needs to be also changed. However, the transactionid of the 
Downloadlnfolndication message is used in other messages also, but the need to change the other messages should 
specifically be avoided and the implications of updating a module should be limited to the module itself and the 
Downloadlnfolndication that references the module. Therefore, additional rules on the usage of the transactionid have 
been specified as follows. 

B.2.7 DVB semantics of the transactionid field 

The transactionid has been split up into a number of sub-fields defined in Table B.32. This reflects the dual role of the 
transactionid (outlined above) and constraints imposed to reduce the effects of updating a module. However, to increase 
interoperability the assignment of the transactionid has been designed to be independent of the expected filtering in target 
MHP terminals. 

Table B.32 : Sub-fields of the transactionid 



Bits 


Value 


Sub-field 


Description 





User-defined 


Updated flag 


This must be toggled every time the control message 
is updated 


1-15 


User-defined 


Identification 


This must and can only be all zeros for the 
DownloadServerlnitiate message. All other control 
messages must have one or more non-zero bit(s). 


16-29 


User-defined 


Version 


This shall be incremented every time the control 
message is updated. The value by which it is 
incremented should be one. 


30-31 


Bit 30 - zero 
Bit 31 - non-zero 


Originator 


This is defined in the DSM-CC specification [26] as 
0x02 if the transactionid has been assigned by the 
network - in a broadcast scenario this is implicit. 



Due to the role of the transactionid as a versioning mechanism, any change to a control message will cause the 
transactionid of that control message to be incremented. Any change to a Module will necessitate incrementing its 
module Version field. This change must be reflected in the corresponding field in the description of the Module in the 
Downloadlnfolndication message(s) that describes it. Since a field in the Downloadlnfolndication message is changed its 
transactionid must be incremented to indicate a new version of the message. Also, any change in the 
DownloadServerlnitiate message implies that its transactionid must also be incremented. However, when the 
transactionid is divided into subfields as specified above, updating a message will change only the Version part of the 
transactionid while the Identification part remains the same. 
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Since the transactionid is used also for identifying the messages when referencing the messages in other structures, it is 
very desirable that these referenced would not need to be updated every time the control message is update. Therefore the 
following rule shall be applied when locating the messages based on the references: 

When locating a message based on the transactionid value used for referencing the message, only the 
Identification part (bits 1...15) shall be matched. 

Using this rule, the implications of updating a module can be limited to the module itself and the 

Downloadlnfolndication message describing the module. Also, this implies that if an MHP terminal wants to find out if a 
particular module that it has retrieved earlier has changed, it needs to filter the Downloadlnfolndication message that 
described that module and check if it has been changed. 

B.2.8 Mapping of objects to data carousel modules 

The DSM-CC Object Carousels allow one or more objects to be carried in one module of the data carousel. In order to 
optimize the performance and memory requirements three additional requirements are specified: 

• When mapping objects to modules of a data carousel, only closely related objects should be put into one module. 
Objects that are not closely related should not be put into the same module. If in the process of retrieving an object 
from the carousel an MHP terminal acquires a module containing multiple objects, it should attempt to cache 
these since the expectation should be that the other objects are related to the object requested and probably will be 
needed soon. 

• The size of a module that contains multiple objects should not exceed 65536 bytes when decompressed . MHP 
terminals complying to this specification are only required to handle modules containing multiple objects where 
the module size when decompressed is 65536 bytes or less. Modules containing a single file message can exceed 
65536 bytes with upper size only limited by the memory resources in the MHP terminal. 

• In addition to the limitations imposed by the 65536 byte limit, directory and service gateway messages are limited 
to 5 12 object bindings per message. 

B.2.9 Compression of modules 

The modules may be transmitted either in uncompressed or compressed form. If the module is transmitted in compressed 
form, this is signalled by including the compressed_module_descriptor in the userlnfo field of the modulelnfo in the 
Downloadlnfolndication message. 

Table B.33 shows the syntax of the compressed_module_descriptor: 

Table B.33 : compressed_module_descriptor 





No. of 
bytes 


Mnemonic 


Value 










compressed_module_descriptor ( ) ( 
descriptor_tag 
descriptor_length 
compression_method 
original_size 

} 


1 
1 
1 

4 


uimsbf 
uimsbf 
uimsbf 
uimsbf 


0x09 



Presence of the compressed_module_descriptor indicates that the data in the module has the "zlib" structure as defined in 
IETF RFC 1950 [76]. 

The MHP terminal shall support the Deflate compression algorithm as specified in IETF RFC 1951 [77]. This is 
signalled by setting the least significant nibble of the compression_method to 0x8 (i.e. compression_method is 
xxxxlOOO). The MHP terminal is not required to support other compression algorithms. 



1. I.e. when the file has been decompressed from the file transport but before the content decoding has started. 
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B.2.10 Mounting an Object Carousel 

The ServiceGateway object is the root directory of the file system dehvered by an Object Carousel and must be acquired 
before any other object can be downloaded. This may be achieved by two compatible mechanisms. The signalling of 
which mechanisms are being supported by a broadcast is provided by the carousel_id_descriptor. 

In this specification the use of the carousel_id_descriptor for signalling is mandatory in the second descriptor loop of a 
PMT (corresponding to a PID on which the DSI message for an Object Carousel is broadcast, i.e. the boot-PID). The 
consequence is that if a PMT second descriptor loop contains a data_broadcast_id_descriptor that provides signalling for 
this specification, it shall also contain a carousel_id_descriptor. 

Note: A single PID shall only contain messages from a single Object Carousel and so only one carousel_id_descriptor 
shall be present in any second descriptor loop. However, a single service may contain more than one Object Carousel. 
Consequently, the carousel_id_descriptor may appear more than once in any single PMT. 

The acquisition of the ServiceGateway object may be via the standard DSI-DII mechanism. This shall be supported by all 
broadcasts regardless of signalling in the carousel_id_descriptor and shall be sufficient for all MHP terminals. 

See also 10.2, "Program Specific Information" on page 79. 

A broadcast may also contain additional information in the carousel_id_descriptor to support the "enhanced" boot 
mechanism. This is signalled by setting the formatid field for this descriptor to 0x01. This additional information is an 
aggregation of all the fields necessary to locate the ServiceGateway, also found in the DSI and DII messages. However, in 
such a case the module containing the ServiceGateway object shall be broadcast on the PID identified by the data_ 
broadcast_id_descriptor. It is optional for both broadcasts and MHP terminals to support this mechanism. 

B.2.10.1 carousel_id_descriptor 

This descriptor is MPEG defined and in this specification may be included in the second descriptor loop of a PMT. 

Table B.34 : Carousel identifier descriptor syntax 



Syntax 


bits 


Type 


Value 


carousel_identif ier_descriptor { 








descriptor_tag 


8 


uimsbf 


0x13 


descriptor_length 


8 


uimsbf 


N1 


carousel_id 


32 


uimsbf 




FormatID 


8 


uimsbf 




if( FormatID == 0x00 ) { 








for ( i=0; i<Nl-5; i++ ) { 








private_data_byte 
} 


8 






1 

if( FormatID == 0x01 ) { 








ModuleVersion 


8 


uimsbf 




Moduleld 


16 


uimsbf 




BlockSize 


16 


uimsbf 




ModuleSize 


32 


uimsbf 




CompressionMethod 


8 


uimsbf 




OriginalSize 


32 


uimsbf 




TimeOut 


8 


uimsbf 




Ob ject Key Length 


8 


uimsbf 


N2<4 


for ( i=0; i<N2; i++ ) { 








ObjectKeyData 
1 


8 


bslbf 




1 

for( i=0; KN1-N2-21; i++ ){ 








private_data_byte 
} 


8 
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Table B.34 : Carousel identifier descriptor syntax 



Syntax 


bits 


Type 


Value 


1 
} 









carousel_id: The 32 bit field it identifies the object carousel with the corresponding carouselld. 

FormatID: This 8 bit integer identifies whether the carousel supports the "enhanced boot" mechanism or not. The value 
0x00 indicates "standard boot", 0x01 indicates that "enhanced boot" is possible. 

ModuleVersion: This 8 bit integer is the version number of the module containing the service gateway. This is 
equivalent to moduleVersion in the DII. 

Moduleld: This 16 bit integer is the identifier of the module in the carousel. This is equivalent to moduleld in the DIL 

BlockSize: This 16 bit integer is the size in bytes of every block in the module (except for the last block which may be 
the same or smaller). This is equivalent to blockSize in the DII. 

ModuleSize: This 32 bit integer is the size of the module in bytes. This is equivalent to moduleSize in the DII. 

CompressionMethod: This 8 bit field identifies the compression algorithm defined in IETF RFC 1950 [76] used to 
compress the module. It is equivalent to compression_method carried in the compressed_module_descriptor in the DII. 

OriginalSize: This 32 bit integer is the size of the data (in bytes) carried by the module before it was compressed. It is 
equivalent to original_size carried in the compressed_module_descriptor in the DII. 

If the module has not been compressed the values of OriginalSize and ModuleSize shall be equal and the value of 
CompressionMethod is not defined. 

TimeOut: This 8 bit integer specifies the timeout in seconds for acquisition of all blocks of the module. 

ObjectKeyLength: This 8 bit integer specifies the number of bytes of ObjectKeyData. 

ObjectKeyData: These 8 bit values form an octet string that identifies the BIOP message that is the ServiceGateway 
message. 

B.2.10.2 DVB-J mounting of an object carousel 

DVB-J causes an object carousel to be mounted using ServiceDomain . attach ( ) . It can be unmounted using 

ServiceDomain . detach ( ) . 

An application manager is also allowed to call these methods implicitly when launching or killing an application in order 
to access the signalled base directory of the application. 

B.2.1 1 Unavailability of a carousel 

Broadcast carousels become permanently unavailable due to changes in the signalling including the following: 

• The component signalled as carrying the DSI is removed from the PMT 

• Any value in the DSI changes. 

• The value of carousel ID associated with the carousel changes. 

• The program disappears from the PAT 

• After an implementation dependent time general failure of the signalling (e.g. non-transmission of the PMT). 
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B.2.12 Delivery of Carousel within multiple services 

A single Object Carousel may be transmitted within more than one service. An example is a single multiplex containing 
multiple services from the same broadcaster A common data service could be supplied in all services by including 
references to the carousel in all PMTs. 

Carousels shall be considered identical if, in the PMTs of the services, all the following hold: 

• Both services are delivered within the same transport stream. 

• Both services list the boot component of the carousel on the same FID. 

• The carousel_id_descriptor for the carousel are identical in both services (so the carousels have the same carousel 
Id and boot parameters). 

• All association tags used in the carousel map to the same PIDs in both services. 

In this case the carousel is transmitted over a single path, but the services are allowed to reference the carousel via a 
number of routes, including deferral to a second PMT via deferred association tags. 
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B.3 AssociationTag Mapping 

B.3.1 Decision algoritiim for association tag mapping 
B.3.1 .1 TapUse is not BIOP_PROGRAM_USE 

The following figure illustrates the decision tree for identifying the elementary stream(s) by which the object carousel is 
distributed: 



association_tag 




Go to other PMT 



Match 



No 



LSB of association_tag 

in (any of the) stream_identifier_ 

descriptors in the elementary 

stream loop 



Yes 



Match 



Invalid Object 
Carousel 



Figure B.1 : Object Carousel ES identification decision tree 

In this specification, the stream_identifier_descriptor shall always be used for assigning a component_tag for the 
elementary streams. Use of association_tag_descriptors is not required. If the association_tag_descriptor is optionally 
used, a stream_identifier_descriptor shall still be present and the tag values shall be set consistently in each descriptor. 
This restriction simplifies the decision tree above so that the second decision can be skipped. 
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B.3.1.2 TapUse is BIOP_PROGRAM_USE 

The decision tree in B.l is not followed when resolving a BlOP_PROGRAM_USE tap as the only valid broadcast 
encoding is for a tap of use BIOP_PROGRAM_USE to resolve to def erred_association_tags_descriptor 
inthePMT even if the deferred_association_tags_de script or identify the current service (i.e stream or 
streamEvent reference itself). If this resolution fails then there is an error in the broadcast. 

B.3.2 DSM-CC association_tags to DVB component_tags 

The component_tag in a PMT's stream_identifier_descriptor is used to relate SI service component information with an 
elementary stream without directly referring to a PID value. Likewise, assocation_tags are used by DSM-CC in order to 
refer to an elementary stream without directly referencing a PID value. An assocation_tag value is mapped to an 
elementary stream by matching the LSB of the assocation_tag with a component_tag. The stream_identifier_descriptor is 
mandatory for all components referenced by an application and/or object carousel. 

Broadcasters may choose to use assocation_tag_descriptors (as defined by ISO/IEC 13818-6 [26]) which should 
(theoretically) be tested for a match before trying component_tags. However, the LSB of the assocation_tag value in an 
assocation_tag_descriptor has to be equal to the component_tag for that PID. Since the component_tag is unique within 
a PMT this removes the need to match against assocation_tag_descriptors. 

The deferrered_assocation_tags_descriptor required by this specification is the adaptation of the ISO/IEC 13818-6 [26] 
descriptor defined in ETSl TR 101 202 [49]. This latter definition standardises a mechanism to signal the original 
network id. 

When attempting to map an assocation_tag to an elementary stream the assocation_tag must first be checked against any 
deferred_association_tags_descriptors in the current PMT (current in this context means the PMT of the service within 
which the assocation_tag is being mapped). If the association_tag matches any of the association_tags present in a 
deferred_assocation_tags_descriptor then the matching process proceeds to the service indicated in that descriptor. The 
MHP terminal is not required to continue its search beyond this second service. 

If the transport_stream_id field in the deferred_association_tags_descriptor is set to 0x0000 then it shall be ignored and 
the MHP terminal is free to choose which transport stream ID it selects when obtaining a service. 

B.3.3 deferred_association_tags_descriptor 

The transport_stream_id field may take value 0x0000 in which case it shall be ignored in resolving the reference. 
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B.4 Example of an Object Carousel (informative) 

The figure below illustrates an object carousel that is distributed over three elementary streams belonging to the same 
service. 



DSI: lOR of Service Gateway 
object_key = k 
module_id = 1 

tap: use = BIOP_DELIVERY_PARA_USE 
association_tag = 1 



PIDn 
component_tag = 1 



Service Gateway 

dirl: object_key = k1 
module_id = 2 

tap: use = BIOP_DELIVERY_PARA_USE 
association_tag = 1 



dir2: object_key = k2 
module_id = 5 

tap: use = BIOP_DELIVERY_PARA_USE 
association_tag = 1 



dir3: object_key = k3 
module_id = 82 

tap: use = BIOP_DELIVERY_PARA_USE 
association_tag = 3 



PID n+2 
component_tag = 3 




Dll 



\k 



mod 2 



mod 3 



\1/ 



mod 4 



\t^ 



mod 5 



mod 6 



mod 81 



mod 82 



mod 83 



mod 84 



Figure B.2 : Example carousel 

The DownloadServerlnitiate (DSI) message is carried on the first elementary stream. It contains the object reference that 
points to the ServiceGateway. The tap with the BIOP_DELIVERY_PARA_USE points to a Downloadlnfolndication 
(DII) message that provides the information about the module and the location where the module is being broadcasted. In 
the example, the ServiceGateway object is in the module number I that is carried on the second elementary stream 
(indicated by a BIOP_OBJECT_USE tap structure in the DII message). 

The ServiceGateway object is a root directory that, in this example, references three subdirectories. Taps with BIOP_ 
DELIVERY_PARA_USE are used in the object references of the subdirectories to provide links to the modules via the 
Downloadlnfolndication (DII) message. The two first subdirectories "dirl" and "dir2" are referenced in the DII message 
that is carried in the first elementary stream. The third subdirectory is referenced in the DII message carried in the third 
elementary stream. 

In this example, the two first elementary streams carry the messages of one logical data carousel while the third 
elementary stream carries the messages of another logical data carousel. All these belong to the same object carousel. In 
the example, the third elementary stream contains the objects in the "dir3" subdirectory and the objects in the "dirl" and 
"dir2" subdirectories are distributed over the first and second elementary stream. 

It is important to note that the third elementary stream may originate from a completely separate source than the first two 
elementary streams. The directory hierarchy and objects contained in the third elementary stream are "mounted" in the 
root directory by providing the "dir3" directory entry with the appropriate location information. 
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This type of structure could be used, for example, in a national information service that contains some regional parts. The 
common national parts could be carried in this example case on the two first elementary streams that are distributed 
unmodified in the whole country. The regional parts are carried in the third elementary stream that is locally inserted at 
each region. From the application's point of view, the common national parts are in the "dirl" and "dir2" subdirectories 
while the regional parts are in the "dir3" subdirectory. 

Another example where this type of structure could be used is if the service contains multiple independent applications. 
In this case, each application could be placed in its own subdirectory and these subdirectories might be carried as 
separate data carousels on different elementary streams. 



B.5 Caching 



This section describes the constraints that an MHP terminal compliant with this specification shall implement when 
caching any content from the object carousel in the memory of the MHP terminal. Caching is optional for the MHP 
terminal, but if implemented shall conform to the constraints set in this section. 

B.5.1 Determining file version 

There is no version number directly related to files (or other BIOP messages), the closest association is the 
module Version in the DII that references the module that contains the BIOP message. Therefore, to ensure that a file is up 
to date the MHP terminal must determine that the moduleVersion for the appropriate module is current and reacquire if 
necessary. The circumstances under which this checking is required are defined by the transparency level as specified in 
the following section. 

B.5. 2 Transparency levels of caching 

The definition of transparency levels describes the behaviour that the MHP terminal shall implement when the content in 
the object carousel is changing. The transparency level determines how certain the MHP terminal is required to be about 
the validity of the content when returning the content to the application. The object carousel provides a mechanism for 
determining version changes of the content by monitoring the DII messages. 

Validity of content is specified here in terms of the version number of the module that is broadcast in the DII message. 
The contents of an object as cached in the memory of the MHP terminal are defined to be valid at a certain point in time 
when the version number of the module in the cache matches the version number of the module as signalled in the DII 
message describing that module as it was last broadcast. Note that the definition is based on the DII message that was last 
broadcast and it may be that the MHP terminal was not filtering for this message at that time and did not receive it. 

From the MHP terminal point of view, the transparency level indicates the constraints that the terminal needs to 
implement for monitoring the DII messages. 

The broadcaster can indicate the appropriate transparency level that shall be applied for a given piece of content by using 
a descriptor associated with a module in the DII message (see "Caching priority descriptor" on page 298). In the absence 
of this descriptor from a module, the transparent caching is the default level. 

B.5. 2.1 Transparent caching 

The transparent caching is a caching level that ensures that the application can not practically notice a difference in the 
validity of the returned content between an implementation that caches content and an implementation that does not 
cache any content. Naturally, an implementation that caches the content will return it to the application faster 

When returning content from the cache to the application, the MHP terminal shall ensure that the version number of the 
cached content matches the version number indicated in the current DII message describing that module. Once a DII has 
been received it can be assumed that it is current at least for 500 ms and after that period until receiving the next instance 
of the relevant DII. If filtering for that DII has not resumed by the end of this period, the state of that DII is to be 
considered unknown until it is received again. 

Therefore, terminals must not return transparently cached data if it has waited more than half a second between receiving 
the relevant DII and starting to filter for that DII again. If the terminal does not resume filtering within the 500ms grace 
period, it must download the relevant DII again when it wishes to use that DII to check cache validity. 

The choice of 500 ms is based on the normal timing uncertainty in data delivery through the broadcast chain and is 
independent of the repetition rate of the DII messages. 
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B. 5. 2. 1.1 Active caching 

There are several ways the MHP terminal can organise its caching strategy. One possible strategy is so-called active 
caching. This means that the terminal has a dedicated section filter for each DII message it needs to monitor. Keeping that 
filter continuously filtering for the DII guarantees that the terminal will notice the update of a module as soon as it 
happens and can thus be aware of the validity of all the content it has cached. 

However, in some cases the DII messages might be sent with a very high repetition rate that may cause a high processing 
load because the terminal needs to do some processing every DII message that it receives. The 500 ms grace period is 
designed to help this, as it allows the terminal to stop the section filter for 500 ms after receiving the DII message. This 
lessens the processing burden on the terminal as it only needs to process each DII message twice a second, even if it may 
be repeated on the transmission much more frequently. 

B. 5. 2. 1.2 Passive cacining 

With active caching, the terminal may need to have a dedicated section filter reserved for each DII message that it needs 
to monitor. This would effectively limit the amount of content that can be cached, possibly to a very small number. 
Therefore, the terminal may choose a so-called passive caching strategy. This means that the terminal does not even try to 
monitor for the DII messages continuously, but each time an application wants to retrieve an object, it at that time 
retrieves the current DII and checks if the cached content is still valid. Although, this strategy imposes a delay before 
returning the content to the application, this delay is usually significantly smaller than having to retrieve the content from 
the broadcast stream. 

B.5.2.1.3 DII repetition rate 

It should be noted that the description of active and passive caching are only informative here and terminal 
implementations can use any strategy fulfilling the normative constraints set above. However, broadcasters should set the 
repetition rate of the DIIs so that a terminal implementing the passive caching strategy will provide the expected benefits 
of caching over a terminal implementing no caching. 

B.5.2.2 Semi-transparent caching 

The semi-transparent caching level allows the MHP terminal to cache the data and also return slightly out-dated data to 
the application. The benefit of this caching level is that it allows terminals to cache larger quantities of content with a 
reasonable resource usage while allowing the data to be returned usually immediately to the application. The semi- 
transparent caching level provides less guarantees about validity of the content, but does not cause the delay implied by 
the passive caching strategy with the transparent caching level. 

When returning content from the cache to the application, the terminal shall ensure that the version number of the cached 
content matches the version number indicated in a valid DII message describing that module. Once a DII has been 
received it can be assumed to be valid at least for 30 s and after that period until receiving the next instance of the relevant 
DII. If filtering for that DII has not resumed by the end of this period, the state of that DII is to be considered unknown 
until it is received again. 

Therefore, terminals must not return semi-transparently cached data if it has waited more than 30 seconds between 
receiving the relevant DII and starting to filter for that DII again. If the terminal does not resume filtering within the 30 s 
grace period, it must download the relevant DII again when it wishes to use that DII to check cache validity. 

B.5.2.2. 1 Implications for the terminal (informative) 

Reasons for selecting the 30 s value for the grace period in the semi-transparent caching level are different from the 
reasons for the 500 ms grace period in the transparent level. The 30 s grace period in this level is intended e.g. to allow 
terminals to keep typically a valid copy of each DII by retrieving each DII in a round robin fashion using a single section 
filter. Naturally, whether this goal can be achieved, depends on the repetition rate of the DIIs and the amount of content 
that is cached. If this is not possible, the terminal might use the passive caching strategy with this transparency level as 
well. These strategies are only examples and the terminal may implement any strategy as long the normative constraints 
defined above are fulfilled (this includes implementing no caching as it is optional, as well as treating the semi- 
transparent level the same as the transparent level). 
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B.5.2.3 Static caching 

When using the static caching transparency level, the MHP terminal shall check the validity of the cached content from 
the version number in the DII message when it is used for the first time during the lifetime of an application instance. 
After the first usage time, the MHP terminal does not need to check the validity of the content during the lifetime of that 
application instance. 

B.5.2.3. 1 Implications for the broadcaster (informative) 

This has the implication, that content with this transparency level is appropriate for very static content that is updated 
only rarely and where the possible update of the content does not need to be noticed by the application during the lifetime 
of one application instance. 

B.5.2.3. 2 Implications for the terminal (informative) 

The MHP terminal, however, is allowed to update the contents of the statically cached files if it notices that they have 
been updated in the carousel as well as use any caching strategy as long as the normative constraint defined above are 
fulfilled (this includes implementing no caching as it is optional, as well as treating the static level the same as the semi- 
transparent and/or the transparent level). 
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Annex D (normative): Text presentation 
D.1 Scope 

This section addresses the following topics: 

• How downloaded fonts are associated with applications and accessed by them 

• The DVB-J APIs that are used for presenting text and their behaviour 
Two levels of interface are addressed: 

• Simple string rendering as supported by Java . awt . Graphics . drawString 

• More complex object rendering as supported by DVB Text Layout Manager as described in U, "(normative): 
Extended graphics APIs" on page 687. 

Other parts of this specification that are related to this topic are: 

• For character sets supported by implementations see E, "(normative): Character set" on page 349. 

• For the font families, sizes, styles and weights supported by implementations see and the presentation of this to 
the API G.4, "Resident fonts and text rendering" on page 358. 

• For the content formats used to deliver fonts see 7.4, "Downloadable Fonts" on page 55. 

D.2 Fonts 

D.2.1 Embedded fonts 

See G.4, "Resident fonts and text rendering" on page 358. 

D.2. 2 Downloaded fonts 
D.2.2.1 Font technology 

See 7.4, "Downloadable Fonts" on page 55. 
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D.2.2.2 

D.2.2.2.1 



Font index files 
Format of file 



The font index file provides a mapping between a font face name and a file containing the font data. The file syntax is 
defined by the XML DTD shown in table D. 1 . 

Table D.I : Font index file syntax definition 



<!ELEMENT f ontdirectory (font+)> 
<! — a font definition — > 

<!ELEMENT font (name, font format , filename, style* , size? ) > 
<! — filename of the font file. 

Because the font directory is per directory, this should 
not contain any directories, but just be a file in that 
directory — > 

<!ELEMENT filename (#PCDATA)> 

<! — font format, e.g. "PER" — > 

< [ELEMENT fontformat (#PCDATA)> 

<! — symbolic name of the font — > 

<!ELEMENT style (#PCDATA)> 
<! — font style — > 

<! ELEMENT name (#PCDATA)> 

<!ELEMENT size EMPTY> 
<!ATTLIST size 

min CDATA "0" 

max CDATA "maxint" 
> 



The PublicLiteral to be used for specifying this DTD in document type declarations of the XML files is: 

"-//DVB//DTD Font Directory 1.0//EN" 

and the URL for the SystemLiteral is: 

"http : //www . dvb . or q/mhp/dtd/ font directory- 1-0 . dtd" 

The Name used in the document type declaration shall be "fontdirectory". 

D.2.2.2.2 Element semantics 

font: There shall be one font element per font file included in the font directory. 

name : Contains the font face name of the font (e.g. "Helvetica") 

fontformat : The file format of the font. For the PFR format used in this specification, this shall be "PFR". 

filename: Relative path to the font file. This is relative to the directory containing the font index file. The separator 
character for directories is "/". As this is a relative path, it shall not begin with a "/" character. 

style : The style elements contain the names of the styles of the font that are contained in this font file. The possible 
values for this specification are "PLAIN", "BOLD", "ITALIC" and "BOLDJTALIC". There is one style element 
included per style contained in the indicated font file, except when all the usable styles of the font are in the same file in 
which case the style elements can be left out. When different styles of the font are contained in separate files, these are 
included in the directory as separate font entities with the same name but different style and filename. 

size: Indicates the size range for which this font file can be used. The min. attribute contains the minimum size in points 
(default is "0"). The max attribute contains the maximum size in points or "maxint" if the maximum size is not limited 
(default is "maxint"). 
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If all the usable sizes of the font are generated using the same font file, the size element can be left out. If there are 
separate files for different sizes, these are included in the directory as separate font entities with the same name and style 
but different size definition and filename. 



D.2.2.2.3 



Example 



Table D.2 : Example index file 



<?xml version=" 1 . " ?> 

<!DOCTYPE fontdirectory PUBLIC "-//DVB//DTD Font Directory 1.0//EN" 
"http : //www. dvb . org/mhp/dtd/ font directory- 1-0 . dtd"> 
<fontdirectory> 
<font> 

<name>Tiresias</name> 
<fontformat>PFR</fontformat> 
<f ilename>tiresias . pf r</f ilename> 
<styie>BOLD</style> 
</font> 
<font> 

<name>Broadcaster X Screen Font</name> 
<fontformat>PFR</fontformat> 
<f iiename>brxsf .pf r</f ilename> 
</font> 
</fontdirectory> 



D.2.2.3 
D.2.2.3.1 



Name and location of font index files 
General 



The specification of font paths and fonts by an application are private to that application, they are not available to other 
applications. 

D.2.2.3.2 Name of file 

The file name shall be: 

"dvb . f ontindex" 

D.2.2.3.3 Location 

The font index file shall be placed in the base directory of the application. 

D.2. 2. 4 Specification of fonts at run time 

D.2.2.4.1 DVB-J 

The implementation locates the font file using the parameters passed to org . dvb . ui . FontFactory . 
createFont ( ) . 

The font file is located by searching the directory for a file where the name element matches the name parameter of a call 
to FontFactory. createFont, astyle element matches the style parameter and the size parameter is within the 
limitations in the size element. 

It is font format specific how the font information for a given name, style and size is encoded in the font file. The name 
and style need to match the corresponding entry in the font file. The font size needs to be within the range supported by 
the font file. 
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D.3 Text rendering 

D.3.1 Low and high level rendering 

Two levels of interface are addressed: 

D.3.1. 1 Low level rendering 

Simple string rendering as supported by : 

Java . awt . Graphics . drawstring 

Java . awt . Graphics . drawChars 

Java . awt . Graphics . drawBytes 

This is referred to as "low level" rendering implying that the application author has significant responsibilities for 
ensuring that the text is visible. This rendering obeys the normal AWT rules. For example, the author is responsible for 
placing individual words or lines of text on to a component. 

org . havi . ui . HDef aultTextLayoutManager shall also be considered as supporting low level rendering except 
that implementations shall respect the rendering settings on the HVisible passed as argument to the render method 
(such as alignment, font and foreground colour). 

D.3.1. 2 High level rendering 

More complex object rendering as supported by: 

org . dvb . ui . DVBTextLayoutManager 

This is referred to as "high level" rendering implying that the application author may need less effort to ensure that the 
text is visible. For example, the author could use the text layout manager to handle flowing paragraphs of text into an 

org. havi .ui . HText object. 

D.3.2 Philosophy 

This section describes "logical" rules that ensure text flows predictably on all receivers and defines some rendering 
requirements to ensure that a minimum acceptable level of text legibility is achieved. The scope of this is much broader 
for "high level" rendering, where rules address text flow in addition to just string rendering. 

No restriction is placed on the rendering technology used in a receiver provided that it achieves the deterministic text 
flow characteristics and the minimum rendering requirements described in this section. 

D.3.2. 1 High level rendering conceptual process 

The conceptual rendering process can be described as follows: 

a) Based on: 

- the size of the object to render into 

- the characteristics of the font (e.g. see D.3. 3.1, "Font bounds" on page 334) 

- any automatic or application controlled insets (see D.3. 5, "Rendering within limits and insets" on page 336) 
calculate: 

- The maximum number of lines of text that may be rendered (see D.3. 8.1, "Number of lines" on page 340) 

- The width available for rendering on each line (see D.3. 9.1, "Available width" on page 343) 

b) Determine how the text to render flows, effectively defining a series of lines to render using: 

- The "logical" rules for calculating the width of rendered text (see D.3. 6, ""logical" text width rules" on 
page 337) 

- The available width for rendering (see D.3. 9. 1, "Available width" on page 343) 

- The rules for breaking text (see D.3. 7, "Line breaking" on page 339) 
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c) Determine where each hne of text to render is placed vertically within the object (see D.3.8, "Positioning lines of 
text vertically within an object" on page 340). 

This needs to consider that: 

- If the number of lines of text to render (from step b) exceeds the maximum number of lines of text that may be 
rendered (from step a) "vertical truncation" may be required, i.e. discard some of the lines to render 

- The positioning of lines to render is affected by the vertical justification setting of the object 

d) Determine the placement of individual characters in a line to render (see D.3.9, "Rendering lines of text 
horizontally" on page 343). This needs to consider that: 

- Even having correctly applied the rules relating to the flow of text, in some extreme circumstances the length of 
the line of text to render can be wider than the available width for rendering (from step a). To handle this 
"horizontal truncation" may be required, i.e. discard some of the characters from the line to render 

- The placement of characters in the line to render is affected by the horizontal justification setting of the object 

- The placement of characters in the line to render should ensure sensible and consistent spacing between adjacent 
characters (see D.3.12, "Placing runs of characters & words" on page 345) 

In addition special rules exist for handling tabulation (D.3.1 1, "Tabulation" on page 345) which need to be taken into 
account in the implementation of many of these steps. 

Behaviour equivalent to the above is required to ensure conformant rendering. The order of these steps is illustrative and 
may vary between implementations for reasons of convenience or efficiency. 

D.3.3 Font Definition 



The nomenclature used in this section is derived from the resident font format(s). The nomenclature and the numerics 
provided here are directly applicable to downloaded fonts. 



D.3.3.1 



Font bounds 



The font definition induces a set of parameters xMin, xMax, yMin and yMax that are properties of the font. These 
define the maximum extent of the outline representation of characters within the physical font, and as such are defined in 
terms of outline resolution units (outlineResolution). 

(xMin, yMin) and (xMax, yMax) are the bottom-left and top-right comers of an imaginary bounding rectangle within 
which all characters in the font can be completely enclosed. 



xMin 



yMin 




Font bounds 

yMax 

xMax 
Character cell origin 



Figure D.1 : Font bounds 

In "Low level rendering" the author is responsible for using knowledge of these values to correctly position text. 

In "High level rendering" the text layout manager uses this information this information when managing text flow to 
guarantee that the extremities of all characters are completely within the object. See D.3.5, "Rendering within limits and 
insets" on page 336. 
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D.3.3.2 



"Physical" font data 



"Physical" font data such as horizontal escapement and kerning is defined in terms of metrics resolution units 
(metricsResolution). This is a high resolution representation, abstracted from any actual rendering system. 

NOTE: The outlineResolution and metricsResolution are not necessarily the same. 

D.3.3.3 Ligatures 

MHP terminals shall not automatically transform letter pairs to ligatures or vice versa at any time. MHP applications 
which wish to see ligatures rendered shall use the appropriate Unicode value and shall ensure that the appropriate Unicode 
character is found in the font being used. 

D.3.4 Converting font metrics to display pixels 

Many of the calculations in this section are in a high resolution physical coordinate system, either metrics or outline 
resolutions. These values need to be converted into the pixel resolution of the HGraphicsDevice to allow characters to be 
rendered. 

Values in terms of these high level resolutions can be simply converted to values in terms of points by multiplying by the 
font size (in points) and dividing by the resolution, i.e. metricsResolution or outlineResolution as appropriate. However, 
this value in points still needs to be converted into a value in pixels. 

Computer display systems typically assume a 72 pixel per inch display. So, as each point is 1/72 inch, the horizontal and 
vertical size of each pixel is 1 point. 



D.3.4. 1 



Vertical resolution 



Each pixel in the graphics device (HGraphicsDevice for DVB-J applications) containing the component is equivalent to a 
single point. 



D.3.4.2 



Horizontal resolution 



The horizontal relationship depends on the characteristics of the graphics device (HGraphicsDevice for DVB-J 
applications). For a square pixel graphics device the 1 pixel = 1 point convention can be preserved. 

However, for a graphics device whose pixel aspect ratio is given by org . havi . ui . HScreenConf iguration . 
getPixelAspectRatio the horizontal resolution is the pixel aspect ratio * 1 point. 

The following table defines the pixel aspect ratios which shall be used when converting typographic pixels for rendering 
in the graphics system of an MHP terminal for each graphics device aspect ratio. 

Table D.3 : Pixel width for non-square pixel graphics devices 



Graphics device 
resolution 


Graphics device aspect 
ratio 


Typographic pixel size 
width in points 


720 X 576 


4:3 


48/45 


14:9 


56/45 


16:9 


64/45 
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An emulated graphics could be constructed with 14:9 aspect ratio. This could be used where text is required to be 
acceptable when viewed on either a 4:3 or 16:9 display. The 14:9 aspect ratio is an artificial construct intended to allow 
easier authoring but text will always be slightly distorted when displayed. 14:9 should be used when maintaining 
character aspect ratio is less important to the application than text occupying the same number of pixels regardless of the 
display size which the MHP terminal is using. A possible example of this is illustrated in figure D.2. 

Text on a 4:3 display 

The quick brown fox jumped over the lazy dog. 
Cozy lummox gives smart squid who asl<s for job pen. 

Text on a 16:9 display 

The quick brown fox jumped over the Lazy dog. 

Cozy lummox gives smart squid who asks for job pen. 

Figure D.2 : Example of 14:9 text on either 4:3 or 16:9 display 

D.3.5 Rendering within limits and insets 

When typesetting for print, character extremities may extend beyond the nominal text flow area. However, print has 
margins so the edge of the text flow is not the technical limit to the area that can be printed. 

D.3.5. 1 Low level rendering 

In "Low level rendering" the author is responsible for placing the text so that is not clipped. 

D.3.5.2 High level rendering 

In "High level rendering" text is automatically rendered with at least a sufficient inset from the object edge (derived from 
the font properties xOf fsetLeft, yOf f setBottom, xMax and yOf f setTop) to ensure that all presented 
characters are completely rendered within the bounds of the object. Applications can further increase this minimum (font 
property determined) inset in the following ways: 

• The Insets parameter on the org. dvb .ui .DVBTextLayoutManager . render method 

• The org. dvb . ui . DVBTextLayoutManager . setlnsets method 

Each of these mechanisms can be used independently. Their effect is cumulative. 

For simplicity, tliese application controlled insets are not described in the specification clauses that follow. In 
relation to the rendering process their behaviour is equivalent to a reduction in the size of the object within which 
the rendering processes acts. 

D.3.5. 3 Conversion of units 

As stated previously, these parameters are defined in outline resolution units and so need to be converted to device pixels. 
Based on the principles described previously (see D.3.4, "Converting font metrics to display pixels" on page 335) this 
can be achieved by the following: 
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D.3.5.3.1 



yOffsetTop 



yOffsetTop .^^,^ = 



div(yMaXj,^n[i^g^^j,jj[^(ij,^ x fontSize, outlineResolution) yMax > 

yMax<0 



D.3.5.3.2 yOffsetBottom 



yOffsetBottonip,,^,, 



div(-yMin^^(,i„gRg^„,^ji„„ X fontSize, outlineResolution) yMin < 

yMin>0 



D.3.5.3.3 



xOffsetLeft 



xOffsetLeft 



pixels 



div(-xMin^m[;jjj.j^gj,jj[mjjjjj x fontSize x 45, outlineResolution x 56) xMin < 

xMin > 



outlineResolution is extracted from the PFR, div (A, B) = ceil (A / B), 7' is a rational divide and ceil(A) is the first inte- 
gral number greater than or equal to A. 

yOffsetTop, yOffsetBottom and xOffsetLeft are all greater than or equal to zero and represent the number of available 
pixels required above, below and to the left of the character origin to prevent clipping of any character in the font. A value 
xOffsetRight could be defined along similar lines but is not relevant to this specification. 

Font bounds 



yOffsetTop 











xOffsetLeft -^ 


* 


Ch 


yOffsetBottom 









Character cell origin 



Figure D.3 : Font bounds 

D.3.6 "logical" text width rules 

This clause applies to both "Low level rendering" and "High level rendering". Its purpose is to ensure that text will flow 
predictably on different receivers and authoring stations, regardless of the quality of the character rendering, a set of 
"logical" text width rules are defined here. 

NOTE: I.e. lines and words will break at the same character position. 

These rules are a simplification of the rules that might be applied in a typographic rendering system. The objective of 
these simplifications is to reduce the receiver complexity required to ensure exact correlation of text flow behaviour. 

The calculation of "logical" text width is based on "physical" font data. This data provides a description of the font at a 
very high resolution, abstracted from any actual rendering system. Consequently, the calculation of the "logical" width of 
a string of characters involves, computing their width at this high resolution and then converting to units appropriate to 
the rendering system, e.g. device pixels, before making decisions about text flow (see "Converting font metrics to display 
pixels"). 



ETSi 



338 ETSITS 101 812V1.3.1 (2003-06) 



In the case of "Low level rendering" it defines the internal computation performed by the AWT routines that measure the 
width of text: 

Java . awt . FontMetrics . charWidth 

Java . awt . FontMetrics . stringWidth 

Java . awt . FontMetrics . bytesWidth 

Due to the rounding processes within the calculations invoking these methods on subsets of a string may not yield the 
same total result as invoking the methods on the complete string. In particular the total of the values returned by j ava . 

awt .FontMetrics . get Widths maybe different from the value returned by Java . awt .FontMetrics . 
StringWidth for the same string. 

In the case of "High level rendering" it defines the computations that the layout manager uses in the following cases: 

• to determine when to wrap lines of text within an object 

• to determine which tab stops text has passed when implementing tab characters 

D.3.6.1 Computing "logical" text width 

The key parameters when calculating the width of a string of N characters are: 

• text font size 

• charSetWidth 

• The metricsResolution 

• Any kerning adjustment 

D.3.6.1. 1 Font sizes 

Font sizes are expressed as the size of an "Em" in units of "points". 

NOTE 1 : Broadly speaking an Em is the minimum distance between the baselines of consecutive lines of text 
in the given font. If text is 48 point then the Em at that size is 48 points. 

NOTE 2: The point is an archaic typographical unit. Traditionally there were 72,27 points to an inch. 
Computerised systems now use 72 points per inch for simplicity. 

D.3.6. 1 .2 Character widths 

The font definition gives the width of each character relative to the size of an Em in metricsResolution units. 

NOTE: If metrics are specified in 1/lOOOths of an Em a character with a width of 0,6 Em will have a set 
width of 600. 

D.3.6.1. 3 Kerning 

For certain character combinations (a "kerning pair") a kerning adjustment may also be provided. Typically kerning 
reduces character spacing for pairs such as AV instead of A V, these provide a signed adjustment to the nominal 
charSetWidth of the first character. 

Like charSetWidth kerning adjustments are in terms of metricsResolution units. 

Kerning adjustments only apply between non whitespace characters, not between the start of a line of text and the edge of 
the object. If justification is being used, only whitespace between words may be adjusted. 

D.3.6. 1 .4 Letter spacing 

Letter spacing allows for expansion/condensation of the character spacing for all of the characters in a object including 
whitespace. 

NOTE: In printing, this is sometimes referred to as tracking. 
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D.3.6.2 Logical text width 

The equation below shows how the width of a string of N characters is computed. 



logical width of N characters 



points 

/N N-1 \ 



div((N - 1 ) X letterspace,256) + div(fontsize x 



^charSetWidth[i] + Y, kern[i,i+l] 
VI 1 



,metricsResolution) 



logical width of N characters jj^gj^, = div(logical width of N characters ^j^j^, x H,W) 

Where in div( A, B ): 

• B is unsigned and A is signed 

and 

• div(A,B) = ceil(A/B) 

Where '/' is a rational divide and ceil(A) is the first integral number greater than or equal to A. So, the calculations round 
up when reducing precision and tend to over estimate the width of text. 

Where H and W are respectively the height and width returned by org . havi . ui . HScreenConf iguration . 
getPixelAspectRatio ( ) . 

D.3.7 Line breaking 

D.3.7.1 Text wrapping setting is false 

When the text wrapping setting is false, text shall break onto a new line only where a Carriage Return character is present 
in the text. The number of lines to render shall be equal to the number of Carriage Returns present, plus one. 

NOTE: The "plus one" ensures that the last line of any text can be presented even if it has not been 
terminated with a Carriage Return. 

D.3.7.2 Text wrapping setting is true 

When the text wrapping setting is true, the text flow may break on to new lines at positions in addition to those caused by 
Carriage Return characters. These additional break positions are defined below. This behaviour is independent of the 
object's horizontal alignment settings and is considered to take place before any truncation (see D.3.8.2, "Truncation" on 
page 341). 

The effect of text wrapping on the rendering process is equivalent to substituting "breaking characters" (defined in table 
D.4, "Special characters" on page 346) with Carriage Return characters at positions determined by the wrapping rules. 

The behaviour of the wrapping process is described below: 

a) Based on the "logical" width of the text, receivers shall determine for each line, the first contiguous sequence of 
non-breaking characters that meets both of the following requirements: 

• would not completely fit within the available width (see D.3.9. 1, "Available width" on page 343) 

• that follows one or more breaking characters 

If such a sequence exists, the breaking character preceding it shall be replaced with a Carriage Return character. 

b) All trailing breaking characters shall be discarded from all lines of text. (Preceding breaking characters are not 
affected). 
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NOTE 1 : In general use this identifies the word in a body of text that if rendered would cause the current line 
to spill outside of the text object. This word becomes the first word in the next line. However, if a 
line starts with a single word that is longer than the width of the object then the line is broken just 
before a following word. 

Example 1 : This illustrates the most common case where the word "won't" does not fit and so is 
broken to the next line. 

Example 2: This illustrates the particular case of a long first word. In this case "is" is the first word 
that does not fit AND is preceded by a breaking character. 

Example 2: This illustrates the consumption of trailing spaces. The line breaks just before the 
second "spaces" (so the next line starts with this word) and all trailing spaces (e.g. after the first 
"spaces,") are discarded). 

NOTE 2: The importance of the removal of trailing breaking characters is particularly visible if the text is 
centred or right justified. For example, the text to be centred becomes "spaces" rather than 
" spaces". 

Example 1: 

this "Some text that won't fit on one line" 



becomes "Some text that<cr> 
won't fit on one<;cr> 
■line" : 



Example 2: 

this 

becomes 



Example 3: 

this 

becomes 



• the " symbol indicates the start or end of a string 



'AntJdisestablishmentarianism is a long word" 

'i^ntidisestablishr(^entarlanism<cr>^ 
is a long word" ■ 



'the <cr> symbol indicates an inserted carriage return 
:the available width for rendering 



spaces, everywhere" 



spaces, ; 

spaces, <cr> 
spaces, <cr> | 
everywhere" 



Figure D.4 : Text wrapping examples 

After text wrapping the text truncation rules have to be considered. For example, in example 2 in figure D.4 the word 
"Antidisestablishmentarianism" will be truncated (see D.3.9.2, "Truncation" on page 343). 

D.3.8 Positioning lines of text vertically within an object 
D.3.8.1 Number of lines 

Assuming that all characters in a line of text share a common baseline then, regardless of the vertical alignment setting 

the number of lines of text that can be presented within an object is: 

num_lines = floor ( (object_height - (yOf f setBottom + yOffsetTop) ) / linespace) + 1 

All values are in pixels. 

object_height: is the height of the component less any margin. 

linespace: is an attribute of the object that defines the space between the baselines of consecutive lines of text. This is 
defined in units of points but is converted to pixels (see D.3.4, "Converting font metrics to display pixels" on page 335). 

The fiinction floor(A) rounds A to the first integral number less than or equal to A. 
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D.3.8.2 Truncation 

When the number of lines of text to be rendered exceeds the available height within the object then lines of text shall be 
discarded as follows: 

• If the vertical alignment setting is VERTICAL_CENTER or VERTIC AL_START_ALIGN then lines are 
discarded from the end of the text. 

• If the vertical alignment setting is VERTICAL_END_ALIGN then lines are discarded from the beginning of the 
text. 

This truncation will result in a number of lines that can be completely displayed within the object. These shall be 
presented according to D.3.8.3, "Positioning" on page 341. 

See also D.3.10, "Text overflow" on page 344. 

D.3.8.3 Positioning 

The origin of any character shall be at least yOf f setTop inside the top edge of the object and at least 

yOf f setBottom inside its bottom edge. 

D.3.8.3.1 Vertical alignment setting is VERTICAL_START_ALIGN 

When the text is top aligned the baseline of the top most line shall be at least yOf f setTop inside the top of the object. 
The baselines of the subsequent lines of text shall be linespace apart. 

D.3.8.3.2 Vertical alignment setting is VERTICAL_END_ALIGN 

When the text is bottom aligned the baseline of the bottom most line shall be at least yOff setBottom inside the 
bottom of the object. The baselines of the preceding lines of text shall be linespace apart. 
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D.3.8.3.3 



Vertical alignment setting is VERTICAL_CENTER 



When the text is vertically centred the positioning of the lines shall be such that the space above the first line of text 
equals the space below the last line of text (to allow for rounding the lower gap may be up to one pixel greater than the 
upper gap). The spacing between the baselines of text shall be linespace. 




object boundary 



ascent line 



yOffsetTop 



baseline 
yOffsetBottom 



yOffsetBottom 
yGap or yGap + 1 



Figure D.5 : Vertical measures 
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D.3.8.3.4 Examples 

VERTICAL. 
START_ 
vertical alignment-> ALIGN 



Right: 


Three '^^^ 
lines of 


Wrong: 


Three 

lines of ^^ 



Wrong: 



VERTICAL. VERTICAL. 

CENTER END ALIGN 



Three 



inree 
lines of 



lines of 
text 

lines of 
text 



J 
J 



String: 

Three lines of text 



uines of ^^ 
Figure D.6 : Vertical positioning example 1 



VERTICAL. 

START_ VERTICAL. VERTICAL, 

vertical alignment-> ALIGN CENTER END.ALIGN 



Right: 
Wrong: 



Final CF 



^g [Final CR ^ 

Final CR miaioiA — 

Figure D.7 : Vertical positioning example 2 



String: 

Final CR<cr> 



D.3.9 Rendering lines of text iiorizontally 
D.3.9.1 Available width 

The number of characters that may be rendered on a Une is not simply dependent upon the width of the object and the 
horizontal escapement for each character, but also needs to consider that the rendering of the first character in a line may 
extend to the left of its origin. Thus, regardless of the horizontal alignment setting the space available for rendering a 
line of text within an object is: 

available_width = object_width - xOffsetLeft 

All values are in pixels. This derivation of available_width shall be used with the "logical" text width rules to 
determine text flow. 

D.3.9.2 Truncation 

Where a line of text is too long to fit within the available_width of the object, the line shall be truncated. 

NOTE: This addresses the case where text wrapping has not made the text fit. This can happen either 
because the text wrapping setting is false, or because a single word is too long to fit. 

The result shall be as if the complete line were aligned appropriately on the object (taking into account the horizontal 
alignment setting) with only those characters which can be completely presented being rendered. That is those 
characters: 

• whose origin is more than xOffsetLeft right of the left hand edge of the object. 

• whose right hand edge falls inside the right hand edge of the object. 
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For example: 

• if the horizontal alignment setting is HORI ZONTAL_END_ALIGN then a portion of text from the right end of the 
line will be rendered with its edge aligned to the right edge of the object. 

• if the horizontal alignment setting is HORIZONTAL_CENTER the centre of the string will appear at the centre of 
the object with excess characters being truncated from each end. 

See also D.3.10, "Text overflow" on page 344. 

D.3.9.3 Placement 

• When the horizontal alignment setting is HORIZONTAL_START_ALIGN the origin of the left most character 
shall be xOff set Left inside the left edge of the object. 

• When the horizontal alignment setting is HORI ZONTAL_CENTER the positioning of the characters shall be such 
that the gap to the left of the text equals the gap to the right (to within one pixel). 

• When the horizontal alignment setting is HORI Z ONTAL_END_AL I GN the origin of the right most character shall 
be as necessary to ensure that it is completely visible when rendered. 

NOTE 1: xOf f setLef t allows for characters (such as capital "J") that extend to the left of their origin. 

xOf f setLeft is aproperty of the font and so represents a consistent indent, i.e. it is independent 
of the first character. 

NOTE 2: There are characters (e.g. fractional divisor) that can extend beyond the escapement indicated by 

their charSetWidth value. These can theoretically extend beyond the right hand edge of the object if 
the character is at the end of a word and that word is at the end of a line and the "logical width" of 
the line just fits the object. With the "fractional divisor" character this is a very unlikely 
combination of circumstances as this character is normally embedded within a "word". The 
handling of cases such as this by the MHP Terminal is implementation dependant. 



HORIZONTAL. HORIZONTAL. HORIZONTAL, 

horizontal alignment-> START.ALIGN CENTER END.ALIGN String: 

iThis text is too lo his text is too Ion is text is too long ^^'^ *®'^* '^ *°° '"-"^S 

Right: I 

Wrong: "'^^'^ '®'^' '^ '°° '^"^ This text is too lor his text is too long 
Wrong: This text is too lo This text is too lo 

Figure D.8 : Horizontal positioning examples 

D.3.10 Text overflow 

The org . dvb . ui . TextOverf lowListener . notif ylextOverf low method is called if truncation occurs. 
NOTE: This can be used by an application to alert the viewer or take other remedial action. 
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D.3.11 Tabulation 

In left aligned text (the horizontal alignment setting is HORI Z0NTAL_START_ALIGN) tab stops are defined at intervals 
of horizontalTabSpace from the left edge of the object. By default the value of horizontalTabSpace is 56 
points. "Horizontal Tabulation" advances the origin of the next character to be rendered to the next tab stop in the 
direction that the text is currently flowing (the character repertoire in Table E.l only requires left to right text). 



tab (x,0) 



tab (x+45,0) 




xOffsetLeft 
xOffsetLeft 

Figure D.9 : Effect of horizontal tabulation 

• Tab characters only have meaning in left aligned text (the horizontal alignment setting is HORI ZONTAL_ 
START_ALIGN). If the text is right aligned, centred or justified then tab character shall be treated as a space 
character. 

• A tab logically advances the rendering ofthe text by at least the width xOffsetLeft. If the normal origin of the 
next character to be rendered after the tab character is after a tab stop, a tab character will advance the rendering to 
the subsequent tab stop. 

• The tab stops are at regular intervals from the left edge ofthe object and are not affected by the xOffsetLeft 
offset to the origin of the first character. 

D.3.12 Placing runs of characters & words 

A run of characters starts from a well defined point: 

• The start edge of the object 

• A tab stop 

After this origin the fine positioning of character cells and the gaps between words is not fiilly specified. 

LogicalTextWidth[a, b, space] 




origin 



Figure D.10 : Calculation of character placement 
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However, the following rendering requirements shall be observed to ensure that a minimum acceptable level of text 
legibility is achieved: 

• The spacing between any pair of non whitespace characters should be consistent wherever that pair of characters 
is displayed. 

• At the default character spacing no two non-whitespace characters should "appear" to touch, except for special 
cases such as where ligatures dipthongs etc. are being used. The definition of the underlying font may make this 
requirement impossible. 

• The physical rendering of a run of text as determined by the "logical" rules shall be achieved completely within 
the space used for the "logical" calculation. 

• No partially rendered characters shall be presented. 

NOTE: The "logical" position of each character as determined by the "logical" rules is likely to be a non- 
integer. For renderers unable to support suitable sub-pixel positioning, e.g. a 1-bit/pixel bitmap 
renderer, this is impossible to implement. Thus, whilst the "logical" rules must be used to determine 
the ilow of text, are not required to be observed for individual character placement within this flow 
and other strategies may be employed as long as the requirements above are satisfied. 

D.3.13 Control of text flow 

See the definition of the DVB text layout manager. 

D.4 Text mark-up 

This clause on text mark-up applies to "High level rendering". 

D.4.1 White Space Characters 

Certain non-printing characters have special meaning. These are identified in Table D.4. 

Table D.4 : Special characters 



UTF8Value(s) 


Character 


Name 


Breaking/ 
Non-breaking 


IVIeaning 


0x09 


0x0009 


Tab 


Breaking 


See "Tabulation" on page 345 


OxOA 


OxOOOA 


Carriage 
Return 


N/A 


Causes the text flow to break. The origin for the 
next character to be rendered moves to a new 
baseline "linespace" below that just rendered. 
The horizontal position of the next line will 
depend on the horizontal alignment setting. 


OxOD 


OxOOOD 


OxODOA 
(note 1) 


OxOOOD 
OxOOOA 


0x20 


0x0020 


Space 


Breaking 


Spaces text by the width defined for the space 
character. When an object has the its text 
wrapping setting set to "true" lines may be 
broken at a space. See D.3.7, "Line breaking" 
on page 339. 


0xC2A0 


OxOOAO 


Non-breaking 
Space 


Non-breaking 


Identical spacing characteristics to 0x20 but is 
not seen as word boundary for deciding a 
position to break a line of text. 
(0xC2A0 is the UTF-8 representation of 
OxOOAO) 


0XE28087 


0x2007 


Figure Space 


Non-breaking 


Can be used in a string of numerals as an 
alternative to using comma to denote 
"thousands". This character is not treated as a 
word boundary when deciding a position to 
break a line of text. 


NOTE 1 : The character sequence OxODOA shall be rendered identically to a single OxOD. 
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D.4.2 Marker characters 

The codes Ox IC to Ox IF are zero width, non-spacing, non-printing characters available for use by authors as markers in 
objects, i.e. when using string operations. 

D.4.3 Non-printing ciiaracters 

Certain characters (or character sequences) have no immediate visual representation. 
These include: 

• OxlC to OxlF marker characters (see D.4.2 on page 347) 

• Format control mark-up (see D.4.4 on page 347) 

• other characters not recognised by the receiver 

When presenting text that includes these characters the character placement shall be as if the non-printing characters 
were eliminated from the text before rendering. In particular, the character spacing and inter character kerning shall be 
computed as if the non-printing characters were not present. 

D.4.4 Format Control Marl<-up 

Within objects mark-up codes can be used to control the presentation of text. The sequence in table D.5 marks the start of 
some marked-up text. For each "start of mark-up" a corresponding "end of mark-up" is defined. The byte sequence for 
the "end of mark-up" is illustrated in Table D.6. The minimum nvunber of supported mark-up instances, where each 
instance is a start and end mark-up pair, is 256. 

Table D.5 : General format for start of text mark-up 





bits 


value 


note 


start_of_markup 


8 


0x1 B 


Escape 


markup_start_identif ier 


8 


0x40-0x5E 


"@" to "'"' 


parameters_length 


8 


N 




for( i=0; i<N; i++ ) ( 








parameter_byte 

} 


8 


0x00... OxFF 





Table D.6 : General format for end of text mark-up 





bits 


value 


note 


end_of_markup 
markup_end_identif ier 


8 
8 


0x18 
0x60-0x7E 


Escape 

iiim i- it_^ii 



Table D.7 : Codes defined for use in marked-up text files 



Min. Nesting 


start mark-up 


end mark-up 


description 




0x1 B 0x42 
0x00 


0x1 B 0x62 


Applies "bold" style to the text 
enclosed (note 1) 


16 


0x18 0x43 

0x04 Oxrr 

Oxgg Oxbb Oxtt 


0x1 B 0x63 


Applies colour to the text enclosed. 
Oxrr specifies the red intensity, Oxgg 
the green, Oxbb the blue and Oxtt 
the transparency. 


NOTE 1 : Not supported in this version of this specification. 

NOTE 2: The required text encoding for this marl<-up format is described in 11.2.11, "Text 
Encodings" on page 106. 
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D.4.5 Future compatibility 

Compatible extensions to the set of mark-up codes may be defined in fiature versions of this specification. For each the 

markup_end_identif ier will be 32 (0x20) greater than the markup_start_identif ier. MHP terminals 
shall ignore unrecognised mark-up and shall display any text enclosed within an unrecognised mark-up. 
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Annex E (normative): 
Character set 

E.1 Basic Euro Latin 
character set 

The MHP shall be able to display and accept as input at 
least the set of characters shown in table E.l "Extended 
Latin set". 

The range of characters accepted as input may be limited 
by the capabilities of the available input devices. This 
paragraph does not imply that keyboards (real and virtual) 
for MHP terminals are required to support input of this full 
character set. 

Table E.1 : Extended Latin set (Sheet 1 of 10) 



Table E.1 : Extended Latin set (Sheet 2 of 10) 



Code 


ISO 10646-1 [18] Character name 


0x0020 


SPACE 


0x0021 


EXCLAMATION MARK 


0x0022 


QUOTATION MARK 


0x0023 


NUMBER SIGN 


0x0024 


DOLLAR SIGN 


0x0025 


PERCENT SIGN 


0x0026 


AMPERSAND 


0x0027 


APOSTROPHE 


0x0028 


LEFT PARENTHESIS 


0x0029 


RIGHT PARENTHESIS 


0x002A 


ASTERISK 


0x002B 


PLUS SIGN 


0x002C 


COMMA 


0x002D 


HYPHEN-MINUS 


0x002E 


FULL STOP 


0x002F 


SOLIDUS 


0x0030 


DIGIT ZERO 


0x0031 


DIGIT ONE 


0x0032 


DIGIT TWO 


0x0033 


DIGIT THREE 


0x0034 


DIGIT FOUR 


0x0035 


DIGIT FIVE 


0x0036 


DIGIT SIX 


0x0037 


DIGIT SEVEN 


0x0038 


DIGIT EIGHT 


0x0039 


DIGIT NINE 


0x003A 


COLON 


0x003B 


SEMICOLON 


0x003C 


LESS-THAN SIGN 


0x003D 


EQUALS SIGN 



Code 


ISO 10646-1 [18] Character name 


0x003E 


GREATER-THAN SIGN 


0x003F 


QUESTION MARK 


0x0040 


COMMERCIAL AT 


0x0041 


LATIN CAPITAL LETTER A 


0x0042 


LATIN CAPITAL LETTER B 


0x0043 


LATIN CAPITAL LETTER C 


0x0044 


LATIN CAPITAL LETTER D 


0x0045 


LATIN CAPITAL LETTER E 


0x0046 


LATIN CAPITAL LETTER F 


0x0047 


LATIN CAPITAL LETTER G 


0x0048 


LATIN CAPITAL LETTER H 


0x0049 


LATIN CAPITAL LETTER 1 


0x004A 


LATIN CAPITAL LETTER J 


0x004B 


LATIN CAPITAL LETTER K 


0x004C 


LATIN CAPITAL LETTER L 


0x004D 


LATIN CAPITAL LETTER M 


0x004E 


LATIN CAPITAL LETTER N 


0x004F 


LATIN CAPITAL LETTER O 


0x0050 


LATIN CAPITAL LETTER P 


0x0051 


LATIN CAPITAL LETTER 


0x0052 


LATIN CAPITAL LETTER R 


0x0053 


LATIN CAPITAL LETTER S 


0x0054 


LATIN CAPITAL LETTER T 


0x0055 


LATIN CAPITAL LETTER U 


0x0056 


LATIN CAPITAL LETTER V 


0x0057 


LATIN CAPITAL LETTER W 


0x0058 


LATIN CAPITAL LETTER X 


0x0059 


LATIN CAPITAL LETTER Y 


0x005A 


LATIN CAPITAL LETTER Z 


0x005B 


LEFT SQUARE BRACKET 


0x005C 


REVERSE SOLIDUS 


0x005D 


RIGHT SQUARE BRACKET 


0x005E 


CIRCUMFLEX ACCENT 


0x005F 


LOW LINE 


0x0060 


GRAVE ACCENT 


0x0061 


LATIN SMALL LETTER A 


0x0062 


LATIN SMALL LETTER B 


0x0063 


LATIN SMALL LETTER C 


0x0064 


LATIN SMALL LETTER D 


0x0065 


LATIN SMALL LETTER E 


0x0066 


LATIN SMALL LETTER F 


0x0067 


LATIN SMALL LETTER G 


0x0068 


LATIN SMALL LETTER H 


0x0069 


LATIN SMALL LETTER 1 


0x006A 


LATIN SMALL LETTER J 
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Table E.1 : Extended Latin set (Sheet 3 of 10) 



Table E.1 : Extended Latin set (Sheet 4 of 10) 



Code 


ISO 10646-1 [18] Character name 


0x006B 


LATIN SMALL LETTER K 


oxooec 


LATIN SMALL LETTER L 


0x006D 


LATIN SMALL LETTER M 


0x006E 


LATIN SMALL LETTER N 


0x006F 


LATIN SMALL LETTER 


0x0070 


LATIN SMALL LETTER P 


0x0071 


LATIN SMALL LETTER Q 


0x0072 


LATIN SMALL LETTER R 


0x0073 


LATIN SMALL LETTER S 


0x0074 


LATIN SMALL LETTER T 


0x0075 


LATIN SMALL LETTER U 


0x0076 


LATIN SMALL LETTER V 


0x0077 


LATIN SMALL LETTER W 


0x0078 


LATIN SMALL LETTER X 


0x0079 


LATIN SMALL LETTER Y 


0x007A 


LATIN SMALL LETTER Z 


0x007B 


LEFT CURLY BRACKET 


0x007C 


VERTICAL LINE 


0x007D 


RIGHT CURLY BRACKET 


0x007E 


TILDE 


OxOOAO 


NO-BREAK SPACE 


OxOOM 


INVERTED EXCLAMATION MARK 


0x00A2 


CENT SIGN 


OxOOAS 


POUND SIGN 


OxOOA4 


CURRENCY SIGN 


OxOOAS 


YEN SIGN 


OxOOAS 


DIAERESIS 


0x00A9 


COPYRIGHT SIGN 


OxOOAA 


FEMININE ORDINAL INDICATOR 


OxOOAB 


LEFT-POINTING DOUBLE ANGLE 
QUOTATION MARK 


OxOOAC 


NOT SIGN 


OxOOAD 


SOFT HYPHEN 


OxOOAE 


REGISTERED SIGN 


OxOOBO 


DEGREE SIGN 


OxOOB4 


ACUTE ACCENT 


0x00B6 


PILCROW SIGN 


0x00B7 


MIDDLE DOT 


OxOOBS 


CEDILLA 


OxOOBA 


MASCULINE ORDINAL INDICATOR 


OxOOBB 


RIGHT-POINTING DOUBLE ANGLE 
QUOTATION MARK 


OxOOBC 


VULGAR FRACTION ONE QUARTER 


OxOOBD 


VULGAR FRACTION ONE HALF 


OxOOBE 


VULGAR FRACTION THREE QUARTERS 



Code 


ISO 10646-1 [18] Character name 


OxOOBF 


INVERTED QUESTION MARK 


OxOOCO 


LATIN CAPITAL LETTER A WITH GRAVE 


OxOOd 


LATIN CAPITAL LETTER A WITH ACUTE 


0x00C2 


LATIN CAPITAL LETTER A WITH 
CIRCUMFLEX 


OxOOCS 


LATIN CAPITAL LETTER A WITH TILDE 


0x00C4 


LATIN CAPITAL LETTER A WITH 
DIAERESIS 


OxOOCS 


LATIN CAPITAL LETTER A WITH RING 
ABOVE 


0x0006 


LATIN CAPITAL LETTER AE 


0x00C7 


LATIN CAPITAL LETTER C WITH 
CEDILLA 


0x0008 


LATIN CAPITAL LETTER E WITH GRAVE 


0x00C9 


LATIN CAPITAL LETTER E WITH ACUTE 


OxOOCA 


LATIN CAPITAL LETTER E WITH 
CIRCUMFLEX 


OxOOCB 


LATIN CAPITAL LETTER E WITH 
DIAERESIS 


OxOOCC 


LATIN CAPITAL LETTER 1 WITH GRAVE 


OxOOCD 


LATIN CAPITAL LETTER 1 WITH ACUTE 


OxOOCE 


LATIN CAPITAL LETTER 1 WITH 
CIRCUMFLEX 


OxOOCF 


LATIN CAPITAL LETTER 1 WITH 
DIAERESIS 


OxOODO 


LATIN CAPITAL LETTER ETH 


OxOODI 


LATIN CAPITAL LETTER N WITH TILDE 


0x00D2 


LATIN CAPITAL LETTER O WITH GRAVE 


OxOODS 


LATIN CAPITAL LETTER O WITH ACUTE 


0x00D4 


LATIN CAPITAL LETTER O WITH 
CIRCUMFLEX 


OxOODS 


LATIN CAPITAL LETTER O WITH TILDE 


0x00D6 


LATIN CAPITAL LETTER O WITH 
DIAERESIS 


0x00D7 


MULTIPLICATION SIGN 


0x00D8 


LATIN CAPITAL LETTER O WITH 
STROKE 


0x00D9 


LATIN CAPITAL LETTER U WITH GRAVE 


OxOODA 


LATIN CAPITAL LETTER U WITH ACUTE 


OxOODB 


LATIN CAPITAL LETTER U WITH 
CIRCUMFLEX 


OxOODC 


LATIN CAPITAL LETTER U WITH 
DIAERESIS 


OxOODD 


LATIN CAPITAL LETTER Y WITH ACUTE 


OxOODE 


LATIN CAPITAL LETTER THORN 


OxOODF 


LATIN SMALL LETTER SHARP S 


OxOOEO 


LATIN SMALL LETTER A WITH GRAVE 


OxOOEl 


LATIN SMALL LETTER A WITH ACUTE 
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Table E.I : Extended Latin set (Sheet 5 of 10) 



Table E.I : Extended Latin set (Sheet 6 of 10) 



Code 


ISO 10646-1 [18] Character name 


0x00E2 


LATIN SMALL LETTER A WITH 
CIRCUMFLEX 


OxOOES 


LATIN SMALL LETTER A WITH TILDE 


OxOOE4 


LATIN SMALL LETTER A WITH 
DIAERESIS 


OxOOES 


LATIN SMALL LETTER A WITH RING 
ABOVE 


0x00E6 


LATIN SMALL LETTER AE 


0x00E7 


LATIN SMALL LETTER C WITH CEDILLA 


OxOOES 


LATIN SMALL LETTER E WITH GRAVE 


0x00E9 


LATIN SMALL LETTER E WITH ACUTE 


OxOOEA 


LATIN SMALL LETTER E WITH 
CIRCUMFLEX 


OxOOEB 


LATIN SMALL LETTER E WITH 
DIAERESIS 


OxOOEC 


LATIN SMALL LETTER 1 WITH GRAVE 


OxOOED 


LATIN SMALL LETTER 1 WITH ACUTE 


OxOOEE 


LATIN SMALL LETTER 1 WITH 
CIRCUMFLEX 


OxOOEF 


LATIN SMALL LETTER 1 WITH 
DIAERESIS 


OxOOFO 


LATIN SMALL LETTER ETH 


OxOOFI 


LATIN SMALL LETTER N WITH TILDE 


0x00F2 


LATIN SMALL LETTER WITH GRAVE 


OxOOFS 


LATIN SMALL LETTER WITH ACUTE 


OxOOF4 


LATIN SMALL LETTER WITH 
CIRCUMFLEX 


OxOOFS 


LATIN SMALL LETTER WITH TILDE 


0x00F6 


LATIN SMALL LETTER WITH 
DIAERESIS 


0x00F7 


DIVISION SIGN 


OxOOFS 


LATIN SMALL LETTER WITH STROKE 


0x00F9 


LATIN SMALL LETTER U WITH GRAVE 


OxOOFA 


LATIN SMALL LETTER U WITH ACUTE 


OxOOFB 


LATIN SMALL LETTER U WITH 
CIRCUMFLEX 


OxOOFC 


LATIN SMALL LETTER U WITH 
DIAERESIS 


OxOOFD 


LATIN SMALL LETTER Y WITH ACUTE 


OxOOFE 


LATIN SMALL LETTER THORN 


OxOOFF 


LATIN SMALL LETTER Y WITH 
DIAERESIS 


0x0100 


LATIN CAPITAL LETTER A WITH 
MACRON 


0x0101 


LATIN SMALL LETTER A WITH MACRON 


0x0102 


LATIN CAPITAL LETTER A WITH BREVE 


0x0103 


LATIN SMALL LETTER A WITH BREVE 



Code 


ISO 10646-1 [18] Character name 


0x0104 


LATIN CAPITAL LETTER A WITH 
OGONEK 


0x0105 


LATIN SMALL LETTER A WITH OGONEK 


0x0106 


LATIN CAPITAL LETTER C WITH ACUTE 


0x0107 


LATIN SMALL LETTER C WITH ACUTE 


0x0108 


LATIN CAPITAL LETTER C WITH 
CIRCUMFLEX 


0x0109 


LATIN SMALL LETTER C WITH 
CIRCUMFLEX 


0x01 OA 


LATIN CAPITAL LETTER C WITH DOT 
ABOVE 


0x01 OB 


LATIN SMALL LETTER C WITH DOT 
ABOVE 


0x01 OC 


LATIN CAPITAL LETTER C WITH CARON 


0x01 OD 


LATIN SMALL LETTER C WITH CARON 


0x01 OE 


LATIN CAPITAL LETTER D WITH CARON 


0x01 OF 


LATIN SMALL LETTER D WITH CARON 


0x0110 


LATIN CAPITAL LETTER D WITH 
STROKE 


0x01 1 1 


LATIN SMALL LETTER D WITH STROKE 


0x0112 


LATIN CAPITAL LETTER E WITH 
MACRON 


0x0113 


LATIN SMALL LETTER E WITH MACRON 


0x0116 


LATIN CAPITAL LETTER E WITH DOT 
ABOVE 


0x0117 


LATIN SMALL LETTER E WITH DOT 
ABOVE 


0x01 IS 


LATIN CAPITAL LETTER E WITH 
OGONEK 


0x0119 


LATIN SMALL LETTER E WITH OGONEK 


0x011 A 


LATIN CAPITAL LETTER E WITH CARON 


0x01 1 B 


LATIN SMALL LETTER E WITH CARON 


0x01 1C 


LATIN CAPITAL LETTER G WITH 
CIRCUMFLEX 


0x01 1 D 


LATIN SMALL LETTER G WITH 
CIRCUMFLEX 


0x01 IE 


LATIN CAPITAL LETTER G WITH BREVE 


0x01 1 F 


LATIN SMALL LETTER G WITH BREVE 


0x0120 


LATIN CAPITAL LETTER G WITH DOT 
ABOVE 


0x0121 


LATIN SMALL LETTER G WITH DOT 
ABOVE 


0x0122 


LATIN CAPITAL LETTER G WITH 
CEDILLA 


0x0123 


LATIN SMALL LETTER G WITH CEDILLA 


0x0124 


LATIN CAPITAL LETTER H WITH 
CIRCUMFLEX 


0x01 2S 


LATIN SMALL LETTER H WITH 
CIRCUMFLEX 
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Table E.1 : Extended Latin set (Sheet 7 of 10) 



Table E.1 : Extended Latin set (Sheet 8 of 10) 



Code 


ISO 10646-1 [18] Character name 


0x0126 


LATIN CAPITAL LETTER H WITH 
STROKE 


0x0127 


LATIN SMALL LETTER H WITH STROKE 


0x0128 


LATIN CAPITAL LETTER 1 WITH TILDE 


0x0129 


LATIN SMALL LETTER 1 WITH TILDE 


0x0 12A 


LATIN CAPITAL LETTER 1 WITH MACRON 


0x01 2B 


LATIN SMALL LETTER 1 WITH MACRON 


0x01 2E 


LATIN CAPITAL LETTER 1 WITH OGONEK 


0x01 2F 


LATIN SMALL LETTER 1 WITH OGONEK 


0x0130 


LATIN CAPITAL LETTER 1 WITH DOT 
ABOVE 


0x0131 


LATIN SMALL LETTER DOTLESS 1 


0x0132 


LATIN CAPITAL LIGATURE IJ 


0x0133 


LATIN SMALL LIGATURE IJ 


0x0134 


LATIN CAPITAL LETTER J WITH 
CIRCUMFLEX 


0x0135 


LATIN SMALL LETTER J WITH 
CIRCUMFLEX 


0x0136 


LATIN CAPITAL LETTER K WITH 
CEDILLA 


0x0137 


LATIN SMALL LETTER K WITH CEDILLA 


0x0138 


LATIN SMALL LETTER KRA 


0x0139 


LATIN CAPITAL LETTER L WITH ACUTE 


0x01 3A 


LATIN SMALL LETTER L WITH ACUTE 


0x01 3B 


LATIN CAPITAL LETTER L WITH CEDILLA 


0x01 3C 


LATIN SMALL LETTER L WITH CEDILLA 


0x01 3D 


LATIN CAPITAL LETTER L WITH CARON 


0x01 3E 


LATIN SMALL LETTER L WITH CARON 


0x01 3F 


LATIN CAPITAL LETTER L WITH MIDDLE 
DOT 


0x0140 


LATIN SMALL LETTER L WITH MIDDLE 
DOT 


0x0141 


LATIN CAPITAL LETTER L WITH STROKE 


0x0142 


LATIN SMALL LETTER L WITH STROKE 


0x0143 


LATIN CAPITAL LETTER N WITH ACUTE 


0x0144 


LATIN SMALL LETTER N WITH ACUTE 


0x0145 


LATIN CAPITAL LETTER N WITH 
CEDILLA 


0x0146 


LATIN SMALL LETTER N WITH CEDILLA 


0x0147 


LATIN CAPITAL LETTER N WITH CARON 


0x0148 


LATIN SMALL LETTER N WITH CARON 


0x0 14A 


LATIN CAPITAL LETTER ENG 


0x0 14B 


LATIN SMALL LETTER ENG 


0x0 14C 


LATIN CAPITAL LETTER WITH 
MACRON 


0x0 14D 


LATIN SMALL LETTER WITH MACRON 


0x0152 


LATIN CAPITAL LIGATURE OE 



Code 


ISO 10646-1 [18] Character name 


0x0153 


LATIN SMALL LIGATURE OE 


0x0154 


LATIN CAPITAL LETTER R WITH ACUTE 


0x0155 


LATIN SMALL LETTER R WITH ACUTE 


0x0156 


LATIN CAPITAL LETTER R WITH 
CEDILLA 


0x0157 


LATIN SMALL LETTER R WITH CEDILLA 


0x0158 


LATIN CAPITAL LETTER R WITH CARON 


0x0159 


LATIN SMALL LETTER R WITH CARON 


0x01 5A 


LATIN CAPITAL LETTER S WITH ACUTE 


0x01 5B 


LATIN SMALL LETTER S WITH ACUTE 


0x01 5C 


LATIN CAPITAL LETTER S WITH 
CIRCUMFLEX 


0x01 5D 


LATIN SMALL LETTER S WITH 
CIRCUMFLEX 


0x01 5E 


LATIN CAPITAL LETTER S WITH 
CEDILLA 


0x01 5F 


LATIN SMALL LETTER S WITH CEDILLA 


0x0160 


LATIN CAPITAL LETTER S WITH CARON 


0x0161 


LATIN SMALL LETTER S WITH CARON 


0x0162 


LATIN CAPITAL LETTER T WITH CEDILLA 


0x0163 


LATIN SMALL LETTER T WITH CEDILLA 


0x0164 


LATIN CAPITAL LETTER T WITH CARON 


0x0165 


LATIN SMALL LETTER T WITH CARON 


0x0166 


LATIN CAPITAL LETTER T WITH STROKE 


0x0167 


LATIN SMALL LETTER T WITH STROKE 


0x0168 


LATIN CAPITAL LETTER U WITH TILDE 


0x0169 


LATIN SMALL LETTER U WITH TILDE 


0x01 6A 


LATIN CAPITAL LETTER U WITH 
MACRON 


0x01 6B 


LATIN SMALL LETTER U WITH MACRON 


0x01 6C 


LATIN CAPITAL LETTER U WITH BREVE 


0x01 6D 


LATIN SMALL LETTER U WITH BREVE 


0x01 6E 


LATIN CAPITAL LETTER U WITH RING 
ABOVE 


0x01 6F 


LATIN SMALL LETTER U WITH RING 
ABOVE 


0x0172 


LATIN CAPITAL LETTER U WITH 
OGONEK 


0x0173 


LATIN SMALL LETTER U WITH OGONEK 


0x0174 


LATIN CAPITAL LETTER W WITH 
CIRCUMFLEX 


0x0175 


LATIN SMALL LETTER W WITH 
CIRCUMFLEX 


0x0176 


LATIN CAPITAL LETTER Y WITH 
CIRCUMFLEX 


0x0177 


LATIN SMALL LETTER Y WITH 
CIRCUMFLEX 
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Table E.1 : Extended Latin set (Sheet 9 of 10) 



Table E.1 : Extended Latin set (Sheet 10 of 10) 



Code 


ISO 10646-1 [18] Character name 


0x0178 


LATIN CAPITAL LETTER Y WITH 
DIAERESIS 


0x0179 


LATIN CAPITAL LETTER Z WITH ACUTE 


0x0 17A 


LATIN SMALL LETTER Z WITH ACUTE 


0x01 7B 


LATIN CAPITAL LETTER Z WITH DOT 
ABOVE 


0x01 7C 


LATIN SMALL LETTER Z WITH DOT 
ABOVE 


0x01 7D 


LATIN CAPITAL LETTER Z WITH CARON 


0x01 7E 


LATIN SMALL LETTER Z WITH CARON 


0x01 CD 


LATIN CAPITAL LETTER A WITH CARON 


0x01 CE 


LATIN SMALL LETTER A WITH CARON 


0x02C6 


MODIFIER LETTER CIRCUMFLEX 
ACCENT 


0x02C7 


CARON (Mandarin Chinese third tone) 


0x02C9 


MODIFIER LETTER MACRON (Mandarin 
Chinese first tone) 


0x02D8 


BREVE 


0x02D9 


DOT ABOVE (Mandarin Chinese light tone) 


0x02DA 


RING ABOVE 


0x02DB 


OGONEK 


0x02DC 


SMALL TILDE 


0x1 E80 


LATIN CAPITAL LETTER W WITH GRAVE 


0x1 E81 


LATIN SMALL LETTER W WITH GRAVE 


0x1 E82 


LATIN CAPITAL LETTER W WITH ACUTE 


0x1 E83 


LATIN SMALL LETTER W WITH ACUTE 


0x1 E84 


LATIN CAPITAL LETTER W WITH 
DIAERESIS 


0x1 E85 


LATIN SMALL LETTER W WITH 
DIAERESIS 


0x1 EF2 


LATIN CAPITAL LETTER Y WITH GRAVE 


0x1 EF3 


LATIN SMALL LETTER Y WITH GRAVE 


0x2007 


FIGURE SPACE 


0x2013 


EN DASH 


0x2014 


EM DASH 


0x2018 


LEFT SINGLE OUOTATION MARK 


0x2019 


RIGHT SINGLE QUOTATION MARK 


0x201 A 


SINGLE LOW-9 QUOTATION MARK 


0x201 C 


LEFT DOUBLE QUOTATION MARK 


0x201 D 


RIGHT DOUBLE QUOTATION MARK 


0x201 E 


DOUBLE LOW-9 QUOTATION MARK 


0x2022 


BULLET 


0x2026 


HORIZONTAL ELLIPSIS 


0x2030 


PER MILLE SIGN 


0x2039 


SINGLE LEFT-POINTING ANGLE 
QUOTATION MARK 



Code 


ISO 10646-1 [18] Character name 


0x203A 


SINGLE RIGHT-POINTING ANGLE 
QUOTATION MARK 


0x2044 


FRACTION SLASH 


0x20AC 


EURO SIGN 


0x2122 


TRADE MARK SIGN 


0x2190 


LEFTWARDS ARROW 


0x2191 


UPWARDS ARROW 


0x2192 


RIGHTWARDS ARROW 


0x2193 


DOWNWARDS ARROW 


0x2212 


MINUS SIGN 


0x2214 


DOT PLUS 


0x2215 


DIVISION SLASH 


0x221 E 


INFINITY 


0x266B 


BEAMED EIGHTH NOTES 


0x2713 


CHECK MARK 


0x2717 


BALLOT X 
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Annex F (informative): Authoring & Implementation 
Guidelines 



F.1 Authoring Guidelines 

• Authoring guidelines are needed to specify those methods, classes and interfaces which are intended for use by 
implementations of JMF players. These methods, classes and interfaces are not intended for use by applications 
except for this purpose and that should be made clear. 

• Authoring guidelines are needed to make it clear that it is optional for JMF controls to have an associated java.awt 
component. This is in the JMF documentation but the phrasing implies this an exceptional case. In many MHP 
receivers, the presence of such a component would be the exceptional case. To be completed. 

F.2 Implementation Guidelines 

To be completed. 

F.3 Authoring guidelines for DVB-J 

To be completed. 
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Annex G (normative): Minimum Platform Capabilities 
G.1 Graphics 

In the area of graphics capability the following requirements are made on MHP terminals: 

G.1.1 Device capabilities 

• The number of DVB-J applications concurrently owning instances of HScene is not limited except by underlying 
platform resources like the total memory of the MHP terminal. The MHP terminal is required to support either the 
"Platforms Supporting a Restricted Multi-Window System" or the "Platforms Supporting a Full Multi-Window 
System" implementation scenarios as defined in org . havi . ui . HSceneFactory. The implementation 
scenario "Platforms Supporting a Single Window System" is not a valid choice for MHP 

• The MHP terminal is not required to provide a mechanism for the end-user to change user input focus between 
HScenes. Hence MHP applications wishing to receive user input focus must explicitly request it. 

• The MHP terminal shall implement at least one HGraphicsDevice which shall be full screen. 

• The MHP terminal shall implement at least one HBackgroundDevice. These are always full screen. 

• The MHP terminal shall implement at least one HVideoDevice which is always capable of being configured to 
be full screen. 

• The MHP terminal shall implement at least one HScreen which shall support at least one video, graphics and 
background device as defined immediately above. 

• The minimum set of required device resolutions that MHP terminals shall support is illustrated in figure G.l. 
Specifically these are: 

- HBackgroundDevice resolution of 720x576 

- HVideoDevice resolution of 720x576 

- HGraphicsDevice resolution of 720x576 

These shall be supported for display aspect ratios of 4:3 and 16:9. These shall be reflected as 

HScreenConf igurations of the respective devices. 

• HEmulatedGraphicsConf igurations shall be supported with the pixel aspect ratios defined in table D.3, 
"Pixel width for non-square pixel graphics devices" on page 335 corresponding to the graphics device aspect ratio 
of 14:9 emulated on both 4:3 and 16:9. 

Optionally MHP terminals may also support square pixel HGraphicsDevice resolutions of 768x576 and 
1024x576 for 4:3 and 16:9 displays respectively. 



(0.0,0.0)1 




(1.0,1.0) 



Figure G.1 : Required device resolutions 
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G.1.2 Video presentation capabilities 

• The following set of standard decoder format conversions shall be supported by all MHP terminals: 

DFC_PROCESSING_CCO 
DFC_PROCESSING_FULL 
DFC_PR0CESSING_LB_1 6_9 
DFC_PROCESSING_PAN_SCAN 
The following modes are optional: 
DFC_PROCESSING_LB_14_9 
DFC_PROCESSING_LB_2_21_l_ON_16_9 
DFC_PROCESSING_LB_2_2 l_l_ON_4_3 

• MHP terminals are required to support both displaying MPEG video without any scaling and with 1/2 scaling 
both vertically and horizontally provided that in this latter case the entire resulting video area is fully on the screen 

• Support for component based JMF players is not required for any profile in this specification. 

G.1.3 Image processing capabilities 

• All DVBGraphics objects shall support SRC and CLEAR and SRC_OVER. 

When SRC_OVER is used with DVBGraphics objects with a sample model of the type TYPE_BASE a perfect 
result is only guaranteed to be produced with alpha values of and 1 . Alpha values other than and 1 can be 
approximated. DVBGraphics object with a type of TYPE_ADVANCED will produce a result as expected but 
those SRC_OVER operations are likely to be slow. 

• DVBGraphics object created from a DVBBufferedlmage with the type TYPE_ADVANCED shall perform SRC_ 
OVER operations without approximations of the compositing rule. 

G. 1.3.1 Composition rules 

MHP terminals are required to implement at least the SRC, SRC_OVER and CLEAR rules when composing graphics 
over video and graphics over graphics. 

G.I .4 Alpha capabilities 

In the composition of the graphics (AWT/HAVi components) with background and video planes (see Figure 23, 
"Overview of AWT / HAVi plane composition" on page 203), the following rules shall be applied for the precision of 
implementation of alpha: 

• MHP terminals are required to implement at least 3 levels of transparency: % (opaque), 100 % (completely 
transparent) and an intermediate value of approximately 30 %. Implementation of additional intermediate levels 
of transparency is optional. 

• Where the MHP terminal cannot implement a particular value of semi-transparency it shall replace it with the 
nearest value of transparency it can implement. 

However, if the encoded value of transparency is in the range 10%-90% / 0xl9-0xE6 it shall not be approximated 
as either 0% or 100% transparency. So, 9% may be approximated as 0% but 10% shall be represented with a value 
in the range 10% to 90% such as 30%. Similarly, 91% may be approximated as 100%. 

Allowed approximations for the composition of graphics over other graphics are defined in 13.6.1.1.2, "Graphics over 
other graphics" on page 215. 
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G.1.5 Colour capabilities 

Logically the colour model is a "true colour" one. However, other implementations are possible. 
Two styles of indexed colour implementations are considered: 

• Dithering 

• Nearest colour match 

Where an indexed colour implementation can accurately reproduce colours using dithering it is considered to be a true 
colour implementation. In this case no restrictions are placed on the CLUT used. 

Where an indexed colour receiver implements a simpler colour matching, or has other limitations on the number of 
colours it represents (for example requiring a reservation to accommodate subtitles). It shall use the 188 colour CLUT 
specified in table G. 1 . The reservation of 64 CLUT locations for use by the subtitling decoder is not appropriate to all 
implementations and assumes a corresponding broadcaster rule of operations restricting subtitle transmissions to use 
only 64 different colours. 

Table G.1 : Palette construction rules 



Transparency 


Alpha 


Additional 

Grey Levels 

(R=G=B) 


Red 


Green 


Blue 


Number 
of colours 


0% 


255 


42,85, 170,212 


0,63, 127, 191, 
255 


0,31,63,95,127, 
159, 191,223, 
255 


0, 127,255 


139 


30% 


179 

(note 1) 


— 


0,85, 170,255 


0,51, 102, 153, 
204, 255 


0,255 


48 


100% 





— 


- 


- 


- 


1 




Total 


188 


NOTE 1 : Where the receiver cannot implement this "ideal" value of semi-transparency it shall replace it with the 

nearest value of semi-transparency it can implement. Note: semi-transparency shall not be approximated as 
either % or 1 00 % transparency. 



The opaque portion CLUT specified in table G. 1 is illustrated in figure G.2. 



i 



Figure G.2 : Opaque CLUT 

G.1.6 MPEG I frame and Video drips 

The minimum positioning and scaling capabilities defined above for MPEG video shall also apply to MPEG I frame and 
Video drips. 

The MHP terminal shall support at least one HStilllmageBackgroundConf iguration. 
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G.2 Audio 

No audio mixing is required. 

Audio played from memory may pre-empt any audio from the transport stream. This may disturb decoding of any 
broadcast video stream. 

Audio from memory shall be output in preference to audio from stream if overall audio output has not been disabled by 
the user On platforms capable of mixing audio from memory with audio from the stream it shall do this if there is a 
stream playing. Where audio from the stream is interrupted, decoding of it shall automatically resume when audio from 
memory ceases if the stream concerned is still playing. This only applies where the audio from memory and the stream 
are both under the control of the same MHP application. Where multiple applications are involved see 9.4, "Inter 
application resource management" on page 77. 

G.3 Video 

The MHP terminal is only required to support decoding of a single video stream at a given time. The number of 
implemented video decoders will affect the functionality of the video and background devices. 

G.4 Resident fonts and text rendering 

G.4.1 The built-in font 

At least the font Tiresias [80] shall be provided. 

The font shall be able to present at least the sizes listed in G.2 and the weight ("PLAIN"). 

Table G.2 : Minimum set of sizes 



Size 
(points) 


TV lines 

(note 1) over 

"Cap-V" 


Informative Name 


36 


24 


Heading / Large subtitle 


31 


21 


Subtitle 


26 


18 


Body (note 2) 


24 


16 


Footnote 


NOTE 1 : The primary definition of the character size is the font size in points, the height 

of a capital letter "V" in TV lines is provided for information only. 
NOTE 2: The default size and style. 



G.4.2 Presentation to DVB-J 

The embedded font "Tiresias" shall have: 

• the logical name "SansSerif (for example returned by Java . awt . Toolkit . getFontList) 

• the family name "Tiresias" (for example returned by Java . awt . Font . get Family) 

• the font face name "Tiresias PLAIN" 

G.4. 3 Text (directions 

The DVBTextLayoutManager is only required to support the following configuration of text direction: 

• LINE ORIENTATION HORIZONTAL and START CORNER UPPER LEFT 
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G.5 Input events 



Table G.3 : Minimum set of input events 



Input event 


VK_ 


_0 to VK_9 






VK_ 


_UP 






VK_ 


_DOWN 






VK_ 


_LEFT 






VK_ 


.RIGHT 






VK_ 


.ENTER 






VK_ 


.TELETEXT 






VK_ 


.COLORED. 


.KEY. 


_0 


VK_ 


.COLORED. 


.KEY. 


_1 


VK_ 


.COLORED. 


.KEY. 


_2 


VK_ 


.COLORED. 


.KEY. 


_3 



This table defines the minimum set of input events which shall be available to the set of running MHP applications if they 
are interested in receiving them. For DVB-J applications, this is described in more detail in 1 1.4.1.4, "Handling of input 
events" on page 114. 

NOTE 1 : They are not guaranteed to be always available to any one MHP application because another 
application running at the same time may have one of these events exclusively reserved. The 
application with focus (if any) always receives all of these events unless another application within 
the same service has requested and been granted exclusive access to one or more events. The 
process for event distribution for DVB-J applications is described in more detail in annex J, 
"(normative): DVB-J event API" on page 367. 

NOTE 2: The user input device for an MHP terminal may support more events than this however this is 
implementation dependent. If more events than this are supported, it is equally implementation 
dependent whether the additional events are sent to MHP applications or sent to the MHP navigator. 
Events which are always sent to the MHP navigator may not be visible at all to MHP applications. 
For example, an MHP receiver using a conventional remote control will probably have program 
up/program down keys which are only ever sent to the navigator and cause service selection when 
received there. 



G.6 Memory 



In order to be able to execute MHP conformance tests, the following minimum memory requirements are defined for 
MHP terminals. All of these are to be measured during normal usage and operational conditions of an MHP terminal. All 
are to be measured in the initXlet method of a DVB-J application which is both the only auto-start application 
signalled in a service and the only application running at that time. 

• Enough memory to successfully load any arbitrary 262 144 (or less) Bytes of Java class files into the memory 
space of the Java virtual machine. Execution of code called as part of initializing fields in classes is excluded from 
consideration as part of "load"ing here. RAM usage by the bytecode verifier is included in consideration as part of 
"load"ing here. 
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Enough memory to do the above and individually each of the following: 

• Enough memory to successfully create a Java byte array of lengths from 1 entry to 262 144 entries. 

• Enough memory to successfully load & display any 720x576 8bit PNG image (conforming to 15.1, "PNG - 
restrictions" on page 230) from a file which contains just the mandatory information and excludes any optional 
extension fields or chunks. 

• Enough memory to successfully load from file & play from memory 5 seconds of audio at 128 kbit/s (where kbit/s 
is as used in ETSI TR 101 154 [9]). It shall be measured using files that do not include any optional extension 
fields. 

• Enough memory to successfully allocate an array of Java . lang . Object of length 16 384 and fill each 
element of this array with a distinct instance of Java . lang . Object. 

The memory requirements detailed in this section are not exhaustive. For example, the specific requirement concerning 
an array of type byte in no way implies that MHP terminals are exempt from requirements found elsewhere in the MHP 
specification (including normatively referenced specifications) for supporting arrays of other types. 

NOTE: Additional detail may be added to these requirements in order to properly enable the MHP 
conformance tests. 

G.7 Other resources 



Table G.4 : Minimum requirements for othier resources 



Feature 


Specification 


gamma correction in the 
receiver 


none 


HAVi mattes 


Platforms are not required to implement the functionality of mattes in HAVi. Non- 
implementation should be implemented as specified by HAVi. 


Overlapping applications 


MHP terminals are not required to support overlapping top level Ul containers (e.g. 
HScenes where DVB-J applications are concerned). 


AIT section filtering 


The implementation is not required to dedicate more than one section filter to 
monitoring the AIT. 


Key lengths for TLS 


Receivers shall support certificate key lengths up to and including 2048 bits for TLS 
(see 12.10, "Security on the return channel" on page 186). 


Key lengths for Application 
Authentication (note 1) 


Receivers shall support certificate key lengths up to and including 4096 bits for 
application authentication (see 12.2, "Authentication of applications" on page 151). 


NOTE 1 : It is not expected that key lengths as large as 4096 bits will be used initially. 



NOTE: The values in the table below are set for the purposes of conformance testing and should not be used 
by application or MHP terminal developers as being indicative of the capabilities of commercial 
products. 

Table G.5 : IVIinimum requirements for other resources for conformance purposes (Sheet 1 of 2) 



Feature 


Specification 


Application accessible timers 
(note 2) 


At least 4 timers for each ServiceContext which can be presenting MHP applications at 
the same time. (i.e. shared between the applications signalled as part of the same 
service), (note 1) 


l\/IPEG-2 transport stream 
network interface 


Shall support at least one network interface enabling reception of an MPEG-2 
transport stream and selection of that transport stream from among those available to 
be received. This shall support those broadcast channel protocols supported by the 
MHP terminal (see 6.2, "Broadcast Channel Protocols" on page 47) and the MHP APIs 
defined to interface to these protocols and to control these interfaces. 
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Table G.5 : Minimum requirements for other resources for conformance purposes (Sheet 2 of 2) 



Feature 


Specification 


Bidirectional IP network 
interface 


MHP terminals supporting the interactive broadcast profile shall support at least one 
network interface for bidirectional IP traffic. This shall support those interaction channel 
protocols supported by the MHP terminal (see 6.3, "Interaction Channel Protocols" on 
page 50) and the MHP APIs defined to interface to these protocols and to control 
these interfaces. 


Conditional access 


None required. 

The absence or optional presence of one shall be correctly reported through the 

Conditional access API. 

Local regulation may require more support than this minimum 


Persistent storage 


At least 4096 bytes. This shall not include the requirements of 12.12, "Platform 
minima" on page 196 for persistent storage of CRLs and RCMMs. 


Application accessible 
l\/IPEG-2 section filters 
(note 2) 


At least 2 shared among all applications signalled as part of the same service, 
(note 1). 


Application accessible DVB- 
J threads (note 2) 


At least 4 shared among all applications signalled as part of the same service. Threads 
created by the platform and used to call methods of the application are excluded from 
this number, (note 1). 


Applications in a service 


MHP terminals shall not impose any arbitrary limit on the number of applications which 
they can support at the same time. 


NOTE 1 : These requirements apply to one set of MHP applications signalled as part of the same service. If an MHP 
terminal supports simultaneous execution of more than one set of signalled applications then it shall make 
available at least these minimum resources for each set of signalled applications which can be executed 
simultaneously. 


NOTE 2: "Application accessible" means guaranteed to be accessible to MHP applications through the API defined in 
this specification for the feature concerned. This must be regardless of the extent of any usage of that 
feature or function as part of the MHP terminal implementation. 
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Annex H (normative): Extensions 

Private protocols and possibly APIs are not precluded and are outside of the scope of the MHP specification. 

The addition of public or protected constructors, methods or fields to classes and interfaces in the org . dvb namespace 
is not allowed. 

Restrictions on proprietary extensions to the org . havi . ui packages are found in section 7.2.2 ("Profile #1: DCMs 
and Application Modules") of HAVi [50]. 
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Annex I (normative): DVB-J fundamental classes 
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Package 

org.dvb.lang 



Description 

Provides those core platform related features not found in the java.lang package. 



Class Summary 


Classes 

DVBClassLoader 


This class loader is used to load classes and resources from a search path of 
URLs referring to locations where Java class files may be stored. 
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org.dvb.lang 

DVBCIassLoader 



Declaration 

public abstract class DVBCIassLoader extends j ava . security . SecureClassLoader 

Java . lang .Object 

H j ava . lang . ClassLoader 

I 

+--java .security. SecureClassLoader 

+ — org.dvb . lang. DVBCIassLoader 

Description 

This class loader is used to load classes and resources from a search path of URLs referring to locations where Java 
class files may be stored. 

The classes that are loaded are by default only allowed to load code through the parent classloader, or from the 
URLs specified when the DVBCIassLoader was created. 



Constructors 

DVBClassLoader(URL[]) 

public DVBCIassLoader (java.net .URL[ ] urls) 

Constructs a new DVBCIassLoader for the given URLs. The URLs will be searched in the order 
specified for classes and resources. 

If there is a security manager, this method first calls the security manager's 
checkCreateCiassLoader method to ensure creation of a class loader is allowed. 

Parameters: 

urls - the URLs from which to load classes and resources 

Throws: 

j ava . lang . SecurityException - if a security manager exists and its 
CheckCreateCiassLoader method doesn't allow creation of a class loader. 

See Also: 

SecurityManager . checkCreateCiassLoader 



DVBClassLoader(URL [1 , ClassLoader) 

public DVBCIassLoader (j ava . net . URL[ ] urls, Java . lang . ClassLoader parent) 

Constructs a new DVBCIassLoader for the given URLs. The URLs will be searched in the order 
specified for classes and resources. 

If there is a security manager, this method first calls the security manager's 
CheckCreateCiassLoader method to ensure creation of a class loader is allowed. 

Parameters: 

urls - the URLs from which to load classes and resources 

parent - the parent classloader for delegation 
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Throws: 

j ava . lang . SecurityException - if a security manager exists and its 
checkCreateCiassLoader metliod doesn't allow creation of a class loader. 

See Also: 

SecurityManager . checkCreateCiassLoader 



Methods 



findClass(String) 

public Java . lang. Class findClass (j ava . lang . String name) 
throws ClassNotFoundException 

Finds and loads the class with the specified name from the URL search path. Any URLs are 
searched until the class is found. 

Parameters: 

name - the name of the class. 

Returns: 

the resulting class. 

Throws: 

j ava . lang . ClassNotFoundException - if the named class COUld not be found. 



newInstance(URL []) 

public static org . dvb . lang . DVBClassLoader newlnstance (Java . net . URL[ ] urls) 

Creates a new instance of DVBClassLoader for the specified URLs. If a security manager is 
installed, the loadciass method of the DVBClassLoader returned by this method will invoke the 
SecurityManager .checkPackageAccess method before loading the class. 

Parameters: 

urls - the URLs to search for classes and resources. 

Returns: 

the resulting class loader 



newInstance(URL[], ClassLoader) 

public static org . dvb . lang . DVBClassLoader newlnstance (Java . net . URL[ ] urls, 
j ava . lang . ClassLoader parent) 

Creates a new instance of DVBClassLoader for the specified URLs. If a security manager is 
installed, the loadClass method of the DVBClassLoader returned by this method will invoke the 
SecurityManager .CheckPackageAccess method before loading the class. 

Parameters: 

urls - the URLs to search for classes and resources. 

parent - the parent class loader for delegation. 

Returns: 

the resulting class loader 



ETSI 



367 ETSITS 101 812V1.3.1 (2003-06) 



Annex J (normative): DVB-J event API 

Applications can use the org . dvb . event API, to receive events without being focused and/or to have exclusive 
access to events. 

J.1 Overview 

This API provides a mechanism allowing MHP applications to influence the routing of events to either MHP applications 
or the navigator. This typically would be used in a mode where the recveiver is primairily used for TV viewing, allowing 
some events to be received by the application, and allowing the navigator to receive those events that are not requested by 
any MHP application. This API enables MHP applications to choose between the following mechanisms for receiving 
events: 

• through the standard j ava . awt mechanism, 

• through the standard j ava . awt mechanism, but for some events to be exclusively accessed by the application, 

• through a mechanism defined by this API, 

• through the mechanism defined by this API, but for some events to be exclusively accessed by the application. 

The last two solutions could be used by non-graphical applications in order to receive events that are coming from the 
user. It could also be used by an invisible application if it wants to be presented when a specific key is pressed. 

If an application wants to have exclusive access to some events and to manage them through the java.awt then it must use 
this API so that it can be aware of the fact that it has lost or gained access to these events. One must notice that an 
application based on awt event mechanism will receive events only if it is focused. 

If an application has acquired exclusive access to receive an event through either of these mechanisms, it will not receive 
this same event through the other mechanism. An application can obtain exclusive access to an event through only one of 
the two mechanisms at a time. 
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The diagram below shows how the MHP terminal decides on the processing of an event (defined by a set of 
keychar/keycode, event id & modifiers). This includes deciding on the mechanisms by which the event will be dispatched 
and the appropriate Java class to encapsulate the event for each of these mechanisms.: 




Figure J.1 :The MHP downloaded application visible event distribution mechanism 
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NOTE: In this diagram, the tenns "AWT queue" and "AWT Event Queue" are intended to apply to both 

events dehvered directly through j ava . awt and to events delivered in HAVi event classes. Events 
delivered in HAVi event classes include HFocusEvents with a keycode as the transfer-id 
as well as HKeyEvents. Hence if a keycode is exclusively reserved by a 
UserEventListener, or by another application through EventManager. 
addExclusiveAccessToAWTEvent ( ) , this does block HFocusEvents being generated if 
that keycode would be the transfer-id of the HFocusEvent 



J.2 The resource management 



An application asking for exclusive access to some events will use the resource framework defined in DAVIC 1.4.1p9 [3] 
so that it can be aware of the fact that it has lost access to the user events it asked for (see the example below). 



J.3 The Event Repository 



The UserEventRepository is the class that is used by the appUcation to define the user events it intends to use. For the 
moment user events are just key events but it is a place-holder for new families of events (voice command for example). 
If an application asks for an exclusive access to events by means of a repository, this exclusive access will be lost at the 
time when one of the event is grabbed by another application. User events that can be accessed by an application are 
defined in the UserEvent class. 

J.3.1 Example 

exclusive access to events for a non-focused application 

import org . da vie .resources. ResourceClient . * ; 
import org . dvb . event . * ; 

class Example implements UserEventListener^. ResourceStatusListener;. ResourceClient { 
private int myStatus ; 
public Example () { 
EventManager em ; 

UserEventRepository repository ; 
em = EventManager . get Instance () ; 
repository = new UserEventRepository ("Rl") ; 
repository .addKey (UserEvent .VK_ENTER) ; 

em. addUserListener ( (UserEventListener) this, (ResourceClient ) this, repository) ; 
em. addRe s our ce St at usE vent Listener (this ) ; 
} 
/** 

* methods defined by the UserEventListener interface. 
*/ 

public void UserEventReceived (UserEvent e) { 

} 

/** 

* Methods defined by the ResourceClient interface. 
*/ 

/** 

* In the case a cooperative application asks for an user event 

* exclusively used by me. 

public boolean requestRelease (ResourceProxy proxy. Object requestData) ( 
String name ; 

// let's retrieve the name of the repository, that I have created, and 
// which contains the user event that the other application asks for. 
name = (RepositoryDescriptor) proxy . getName () ; 
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if { {name . compareTo ( "Rl" ) == 0) & (my St at us == ...) ) 

// Ok I release this event . 

return true ; 
} else ( 

// No I need this event, sorry ! 

return false ; 



public void release (ResourceProxy proxy) ( 



public void notifyRelease (ResourceProxy proxy) { 



} 

public void statusChanged (ResourceStatusEvent event) ( 



J.4 Unicode 

References to "Unicode" in the following API description shall be interpreted as references to ISO 10646-1 [18]. 

J.5 Virtual {keyboards 

On platforms where key events are generated from a sequence of other (intermediate) key events, the intermediate key 
events shall not be visible to MHP applications by any mechanism. Examples of these intermediate key events include; 

• For a virtual keyboard, the sequence of keys used to navigate around that keyboard (e.g. VK_UP, VK_LEFT, VK_ 
ENTER) 

• For multi-key press entry (as used in some mobile phones), the keys pressed before the final value is resolved. 
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Package 

org.dvb.event 



Description 

Provides access to user input events before they are processed through the event mechanism of the java.awt 
package. 

The algorithm used for generating UserEvents by the MHP terminal when reporting user input to MHP 
applications shall be the same as that used for Java. awt.event.KeyEvent. For example, pressing the Shift key will 
cause a KEY_PRESSED event with a VK_SHIFT keyCode, while pressing the 'a' key will result in a VK_A 
keyCode. After the 'a' key is released, a KEY_RELEASED event will be fired with VK_A, followed by a 
KEY_TYPED event with a keyChar value of 'A. 



Class Summary 


Interfaces 




UserEventListener 


The listener interface for receiving user inputs. 


Classes 




EventManager 


The event manager allows an application to receive events coming from the 




user. 


OverallRepository 


This class defines a repository which initially contains all the user events which 




can be delivered to an application. 


RepositoryDescriptor 


An instance of this class will be sent to clients of the DVB event API to notify 




them (through the interface org.davic.resources.ResourceClient) when they 




are about to lose, or have lost, access to an event source. 


UserEvent 


Represents a user event. 


UserEvent Avail - 


This event is sent to the resource status event listeners when user input events 


ableEvent 


which had been exclusively reserved by an application are no longer exclu- 




sively reserved. 


UserEventRepository 


The application will use this class to define the events that it wants to receive. 


UserEventUnavail- 


This event is sent to the resource status event listeners when user input events 


ableEvent 


are exclusively reserved by an application. 
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org. dvb. event 

EventManager 



Declaration 

public class EventManager implements org . davic . resources .ResourceServer 
Java . lang .Object 

+ — org . dvb . event . EventManager 

All Implemented Interfaces: 

org. davic .resources . ResourceServer 

Description 

The event manager allows an application to receive events coming from the user. These events can be sent 
exclusively to an application or can be shared between applications. The Event Manager allows also the application 
to ask for exclusive access to some events, these events being received either from the standard Java. awt event 
mechanism or by the mechanism defined in this package. The EventManager is either a singleton for each MHP 
application or a singleton for the MHP terminal. 

The right to receive events is considered as the same resource regardless of whether it is being handled exclusively 
or shared. An application successfully obtaining exclusive access to an event results in all other applications losing 
access to that event, whether the access of those applications was shared or exclusive. 



Constructors 



EventManagerQ 

protected EventManager ( ) 

Constructor for instances of this class. Tinis constructor is provided for tiie use of implementations 
and specifications which extend this specification. Applications shall not define sub-classes of this 
class. Implementations are not required to behave correctly if any such application defined sub- 
classes are used. 



Methods 



addExclusiveAccessToAWTEvent(ResourceClient, UserEventRepository) 

public boolean addExclusiveAccessToAWTEvent (org. davic . resources .ResourceClient client, 
org . dvb . event . UserEventRepository userEvents) 

An application should use this method to express its intend to have exclusive access to some events, 
but for these events to be received through the Java. awt mechanism. The events the application 
wishes to receive are defined by the means of the UserEventRepository class. This repository is 
resolved at the time when this method call is made and adding or removing events from the 
repository after this method call doesn't affect the subscription to those events. An exclusive event 
will be sent to the application if this latest is focused. 
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The effect of multiple calls to this method by the same application with different instances of 
UserEventRepository shall be cumulative. If multiple calls to this method succeed in acquiring the 
events in the specified repositories then the semantics of each successful method call shall be 
obeyed as specified. 

Parameters: 

client - resource client. 

userEvents - the user events the application wants to be inform of. 

Returns: 

true if the events defined in the repository have been acquired, false otherwise. 

Throws: 

Java. lang. II legal ArgumentExcept ion - if the client argument is set to null. 



addResourceStatusEventListener(ResourceStatusListener) 

public void addResourceStatusEventListener (org . davic . resources . ResourceStatusListener 
listener) 

Adds the specified resource status listener so that an application can be aware of any changes 
regarding exclusive access to some events. 

Specified By: 

addResourceStatusEventListener in interface ResourceServer 

Parameters: 

listener - the resource status listener. 



addUserEventListener(UserEventListener, ResourceClient, UserEventRepository) 

public boolean addUserEventListener (org. dvb . event . UserEventListener listener, 
org . davic .resources .ResourceClient client, 
org . dvb . event . UserEventRepository userEvents) 

Adds the specified listener to receive events coming from the user in an exclusive manner. The 
events the application wishes to receive are defined by the means of the UserEventRepository class. 
This repository is resolved at the time when this method call is made and adding or removing events 
from the repository after this method call doesn't affect the subscription to those events. The 
ResourceClient parameter indicates that the application wants to have an exclusive access to the 
user event defined in the repository. 

The effect of multiple calls to this method by the same application with different instances of 
UserEventRepository shall be cumulative. If multiple calls to this method succeed in acquiring the 
events in the specified repositories then the semantics of each successful method call shall be 
obeyed as specified. Note that this can result in applications receiving the same event through more 
than one event listener. 

Parameters: 

listener - the listener to receive the user events. 

client - resource client. 

userEvents - a class which contains the user events it wants to be informed of. 

Returns: 

true if the events defined in the repository have been acquired, false otherwise. 

Throws: 

Java. lang. II legal ArgumentExcept ion - if the client argument is set to null. 
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addUserEventListener(UserEventListener, UserEventRepository) 

public void addUserEventListener (org . dvb . event . UserEventListener listener, 
org . dvb . event . UserEventRepository userEvents) 

Adds the specified listener to receive events coming from tine user. Tine events tine application wishes 
to receive are defined by the means of the UserEventRepository class. This repository is resolved at 
the time when this method call is made and adding or removing events from the repository after this 
method call doesn't affect the subscription to those events. 

The effect of multiple calls to this method by the same application with different instances of 
UserEventRepository shall be cumulative. If multiple calls to this method succeed in acquiring the 
events in the specified repositories then the semantics of each successful method call shall be 
obeyed as specified. Note that this can result in applications receiving the same event through more 
than one event listener. 

Parameters: 

listener - the listener to receive the user events. 

userEvents - a class which contains the user events it wants to be informed of. 



getlnstanceO 

public static org . dvb . event . EventManager getlnstanceO 

This method returns the sole instance of the EventManager class. The EventManager class is a 
singleton. 

Returns: 

the instance of the EventManager. 

removeExclusiveAccessToAWTEvent(ResourceClient) 

public void removeExclusiveAccessToAWTEvent (org. davic . resources . ResourceClient client) 

The application should use this method to release its exclusive access to user events defined by the 
means of the addExclusiveAccessToAWTEvent method. 

Parameters: 

client - the client that is no longer interested in events previously registered. 

removeResourceStatusEventListener(ResourceStatusListener) 

public void removeResourceStatusEventListener (org . davic . resources . ResourceStatusListener 
listener) 

Removes the specified resource status listener. 

Specified By: 

removeResourceStatusEventListener in interface ResourceServer 

Parameters: 

listener - the listener to remove. 

removeUserEventListener(UserEventListener) 

public void removeUserEventListener (org. dvb . event .UserEventListener listener) 

Removes the specified listener so that it will no longer receives user events. If it is appropriate (i.e 
the application has asked for an exclusive access), the exclusive access is lost. 

Parameters: 

listener - the user event listener. 
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org. dvb. event 

OverallRepository 

Declaration 

public class OverallRepository extends UserEventRepository 

Java . lang .Object 

H org . dvb . event . RepositoryDescriptor 

I 

H org . dvb . event .UserEventRepository 

+ — org. dvb .event .OverallRepository 

All Implemented Interfaces: 

org. da vie .resources . Re sou roe Proxy 

Description 

This class defines a repository which initially contains all the user events which can be delivered to an application. 
This includes all keycodes for which KEY_PRESSED and KEY_RELEASED events can be generated and all 
keychars for which KEY_TYPED events can be generated. Note that the set of keycodes and keychars which can 
be generated is dependent on the input devices of the MHP terminal. For example, this pre-defined repository could 
be used by an application, which requires a pin code from the user, in order to prevent another applications from 
receiving events. 

See Also: 

UserEvent, org . havi . ui . event . HKeyCapabilities 



Constructors 

OverallRepositoryO 

public OverallRepositoryO 

The constructor for the repository. The name of the constructed instance (as returned by getName()) 
is implementation dependent. 

OverallRepository(String) 

public OverallRepository (j ava . lang . String name) 

The constructor for the repository with a name. 

Parameters: 

name - the name to use for the repository 
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org. dvb. event 

RepositoryDescriptor 



Declaration 

public class RepositoryDescriptor implements org . davic . resources .ResourceProxy 
Java . lang .Object 

+ — org . dvb . event . RepositoryDescriptor 

All Implemented Interfaces: 

org. davic .resources .ResourceProxy 

Direct Known Subclasses: 

UserEventRepository 

Description 

An instance of this class will be sent to clients of the DVB event API to notify them (through the interface 
org.davic.resources.ResourceClient) when they are about to lose, or have lost, access to an event source. This 
object can be used by the application to get the name of the repository from which it will no longer be able to 
receive events. 



Methods 

getCUentQ 

public org . davic . resources . ResourceClient getClient ( ) 

Return the object which asked to be notified about withdrawl of the event source. This is the object 
passed as the ResoourceCiient to whichever of the various 'add' methods on EventlVlanager was 
used by the application to express interest in this repository. 

Specified By: 

getClient in interface ResourceProxy 

Returns: 

the object which asl<ed to be notified about withdrawl of the event source. If the 
UserEventRepository has not yet been added to an EventManager then null shall be 
returned. Once the UserEventRepository has been added, the last used ResourceClient 
shall be returned even if the UserEventRepository has been since removed. 

getNameO 

public Java . lang. String getName ( ) 

Returns the name of the repository to which the lost, or about to be lost, user event belongs. 

Returns: 

String the name of the repository. 
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org. dvb. event 

UserEvent 



Declaration 

public class UserEvent extends j ava . util .EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+--org . dvb . event . UserEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Represents a user event. A user event is defined by a family, a type and eitlier a code or a character. Unless stated 
otherwise, all constants used in the specification of this class are defined in j ava . awt . event . KeyEvent and 
its parent classes. 



Fields 

UEF_KEY_EVENT 

public static final int UEF_KEY_EVENT 

the family for events that are coming from the remote control or from the keyboard. 



Constructors 



User Even t(Object, int, char, long) 

public UserEvent (j ava . lang .Object source, int family, char keyChar, long when) 

Constructor for a new UserEvent object representing a key being typed. This is the combination of a 
key being pressed and then being released. The type of UserEvents created with this constructor 
shall be KEY_TYPED. Key combinations which do not result in characters, such as keys like the red 
key on a remote control, shall not generate KEY_TYPED events. key_typed events shall have no 
modifiers and hence shall not report any modifiers as being down. 

Parameters: 

source - the EventManager which is the source of the event 



family - the event family 

keyChar - the character typed 

when - a long integer that specifys the time the event occurred 

Since: 

MHP 1.0.1 
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User Even t(Object, int, int, int, int, long) 

public UserEvent (j ava . lang .Object source, int family, int type, int code, int modifiers, 
long when) 

Constructor for a new UserEvent object representing a key being pressed. 

Parameters: 

source - tine EventManager winicin is tine source of tine event 

family - the event family. 

type - tine event type. Eitiier one of KEY_PRESSED or KEY_RELEASED. 

code - Vne event code. One of tiie constants wiiose name begins in "VK_" defined in 
java.awt.event.KeyEvent or org. inavi.ui. event. HRcEvent. 

modifiers - tine modifiers active winen tine l<ey was pressed. Tinese iiave the same semantics 
as modifiers in j ava . awt . event . KeyEvent. 

when - a long integer that specifys the time the event occurred 



Methods 



getCodeO 

public int getCode ( ) 

Returns the event code. For KEY_TYPED events, the code is VK_UNDEFINED. 

Returns: 

an int representing the event code. 



getFamilyO 

public int getFamilyO 

Returns the event family Could be UEF_KEY_EVENT. 

Returns: 

an int representing the event family. 



getKeyCharO 

public char getKeyChar ( ) 

Returns the character associated with the key in this event. If no valid Unicode character exists for 



this key event, keyChar is CHAR_UNDEFINED. 

Returns: 

a character 

Since: 

MHP 1.0.1 



getModifiersO 

public int getModifiersO 

Returns the modifiers flag for this event. This method shall return for UserEvents constructed using 
a constructor which does not include an input parameter specifying the modifiers. 
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Returns: 

the modifiers flag for tiiis event 

Since: 

IVIHP 1.0.1 



getTypeO 

public int getTypeO 

Returns tine event type. Could be KEY_PRESSED, KEY_RELEASED or KEY_TYPED. 

Returns: 

an int representing the event type. 



getWhenO 

public long getWhen ( ) 

Returns the timestamp of when this event occurred. 

Returns: 

a long 

Since: 

MHP 1.0.2 



IsAltDownQ 

public boolean isAltDownO 

Returns whether or not the Alt modifier is down on this event. This method shall return false for 
UserEvents constructed using a constructor which does not include an input parameter specifying 
the modifiers. 

Returns: 

whether the Alt modifier is down on this event 

Since: 

MHP 1.0.1 



isControlDownO 

public boolean isControlDown ( ) 

Returns whether or not the Control modifier is down on this event. This method shall return false for 
UserEvents constructed using a constructor which does not include an input parameter specifying 
the modifiers. 

Returns: 

whether the Control modifier is down on this event 

Since: 

MHP 1.0.1 
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isMetaDownQ 

public boolean isMetaDownO 

Returns whether or not the Meta modifier is down on this event. This method shall return false for 
UserEvents constructed using a constructor which does not include an input parameter specifying 
the modifiers. 

Returns: 

whether the Meta modifier is down on this event 

Since: 

MHP 1.0.1 



isShiftDownO 

public boolean isShiftDownO 

Returns whether or not the Shift modifier is down on this event. This method shall return false for 
UserEvents constructed using a constructor which does not include an input parameter specifying 
the modifiers. 

Returns: 

whether the Shift modifier is down on this event 

Since: 

MHP 1.0.1 
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org. dvb. event 

UserEventAvailableEvent 



Declaration 

public class UserEventAvailableEvent extends org . davic . resources .ResourceStatusEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I org . davic . resources .ResourceStatusEvent 

+ — org . dvb . event . UserEventAvailableEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent to the resource status event listeners when user input events which had been exclusively reserved 
by an application are no longer exclusively reserved. Where one change in user input event reservation results in 
instances of this event being sent to several applications, the following shall apply. 

• Each application shall receive its own instance of the UserEventRepository object which forms the 
source to this event. Any changes made to that repository by any one application shall not impact the instance 
seen by any other application. 

• Any application receiving an instance of this event is allowed to attempt to to exclusively reserve some of the 
newly available user events. In this situation, the normal resource management policy of the platform as 
described elsewhere in this specification shall be obeyed. 

• Any applications which have registered for shared access to any of these user events shall start receiving those 
events following receipt of this event. 

Since: 

MHP 1.0.2 



Constructors 



UserEventAvailableEvent(Obj ect) 

public UserEventAvailableEvent (Java . lang .Object source) 

Constructor for the event. 

Parameters: 

source - a UserEventRepository which contains the events which stopped being 
exclusively reserved. 

Since: 

MHP 1.0.2 
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Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns a UserEventRepository which contains the events which were formerly exclusively 



reserved as passed into the constructor of the instance. 

Overrides: 

getSource in class ResourceStatusEvent 

Returns: 

a UserEventRepository 

Since: 

MHP 1.0.2 
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org. dvb. event 

UserEventListener 



Declaration 

public interface UserEventListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

The listener interface for receiving user inputs. 



Methods 

userEventReceived(UserEvent) 

public void userEventReceived (org . dvb . event . UserEvent e) 

Called by the platform when a user input is received. 

Parameters: 

e - the user input event which was received 
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org. dvb. event 

UserEventRepository 

Declaration 

public class UserEventRepository extends RepositoryDescriptor 

Java . lang .Object 

H org . dvb . event . RepositoryDescriptor 

I 

+--org . dvb . event . UserEventRepository 

All Implemented Interfaces: 

org. da vie .resources . Re source Proxy 

Direct Known Subclasses: 

OverallRepository 

Description 

The application will use this class to define the events that it wants to receive. Events that are able to be put in the 
repository are defined in the UserEvent class. 

Where a repository includes a KEY_PRESSED type event without the KEY_RELEASED type event for the same 
key code or vice versa then exclusive reservations shall be made for both event types but only the one requested 
shall be received by the listener. Where a repository includes a KEY_TYPED event without the corresponding 
KEY_PRESSED and KEY_RELEASED events (excluding KEY_PRESSED or KEY_RELEASED events for 
modifiers), when an exclusive reservation is requested, it shall also be made for those corresponding 
KEY_PRESSED and KEY_RELEASED events but only the requested event shall be received by the hstener. 

Repositories do not keep a count of the number of times a particular user event is added or removed. Repeatedly 
adding an event to a repository has no effect. Removing an event removes it regardless of the number of times it has 
been added. For example, org.dvb.event.UserEventRepository.addUserEvent(UserEvent event) does nothing in 
case that the event is already in the repository. Events are considered to be already in the repository if an event with 
the same triplet of family, type and code is already in the repository. 

If an application loses exclusive access to a repository, it shall lose access to all events defined in that repository. 
Repositories are resolved when they are passed into the methods of EventManager. Adding or removing events 
from the repository after those method calls does not affect the subscription to those events. 

Unless stated otherwise, all constants used in the specification of this class are defined in 

j ava . awt . event . KeyEvent and its parent classes and not in this class. 

See Also: 

UserEvent 

Constructors 



UserEventRepository(String) 

public UserEventRepository (Java . lang . String name) 

The method to construct a new UserEventRepository. 

Parameters: 

name - the name of the repository. 
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Methods 



addAllArrowKeysO 

public void addAllArrowKeys ( ) 

Adds the key codes for the arrow keys (VK_LEFT, VK_RIGHT, VK_UP, VK_DOWN). Any key codes 
already in the repository will not be added again. After calling this method, the keycodes shall be 
present for both the key_pressed and key_released modes. 



addAllColourKeysO 

public void addAllColourKeysO 

Adds the key codes for the colour keys (VK_COLORED_KEY_0, VK_C0L0RED_KEY_1, 
VK_C0L0RED_KEY_2, VK_C0L0RED_KEY_3). Any key codes already in the repository will not 
be added again. After calling this method, the keycodes shall be present for both the key_pressed 

and KEY RELEASED modes. 



addAllNumericKeysO 

public void addAllNumericKeysO 

Adds the key codes for the numeric keys (VK_0, VK_1, VK_2, VK_3, VK_4, VK_5, VK_6, VK_7, 
VK_8, VK_9). Any key codes already in the repository will not be added again. After calling this 
method, the keycodes shall be present for both the key_pressed and key_released modes. 

addKey(int) 

public void addKey(int keycode) 

Adds the specified keycode to the repository. Keycodes added in this way shall be listed in the list of 
user events returned by the getUserEvent method. If a key is already in the repository, this method 
has no effect. After calling this method, the keycode shall be present for both the key_pressed and 

KEY_RELEASED modeS. 

Parameters: 

keycode - the key code. 

addUserEvent(UserEvent) 

public void addUserEvent (org . dvb . event . UserEvent event) 

Adds the given user event to the repository. The values of the modifiers (if any) in the UserEvent 
shall be ignored by the MHP terminal. The value of the source used to construct the specified 
UserEvent shall be ignored by the MHP terminal when the UserEventRepository is used to 
specify events which an application wants to receive. 

Parameters: 

event - the user event to be added in the repository 
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getUserEventO 

public org. dvb. event .UserEvent[ ] getUserEventO 

Returns the list of the user events that are in the repository. 

Returns: 

an array which contains the user events that are in the repository. 

removeAUArrowKeysO 

public void removeAllArrowKeys ( ) 

Removes the l<ey codes for the arrow l<eys (VK_LEFT, VK_RIGHT, VK_UP, VK_DOWN). Key codes 
from this set which are not present in the repository will be ignored. After calling this method, the 
keycodes shall not be present for both the key_pressed and key_released modes. 

removeAUColourKeysO 

public void removeAllColourKeys ( ) 

Removes the key codes for the colour keys (VK_COLORED_KEY_0, VK_C0L0RED_KEY_1, 
VK_C0L0RED_KEY_2, VK_C0L0RED_KEY_3). Key codes from this set which are not present in 
the repository will be ignored. After calling this method, the keycodes shall not be present for both 

the KEY_PRESSED and key_released modes. 

removeAUNumericKeysO 

public void removeAUNumericKeysO 

Remove the key codes for the numeric keys (VK_0, VK_1 , VK_2, VK_3, VK_4, VK_5, VK_6, VK_7, 
VK_8, VK_9). Key codes from this set which are not present in the repository will be ignored. After 
calling this method, the keycodes shall not be present for both the key_pressed and 

KEY RELEASED modeS. 



removeKey(int) 

public void removeKey (int keycode) 

The method to remove a key from the repository. Removing a key which is not in the repository has 
no effect. After calling this method, the keycode shall not be present for both the keypressed and 

KEY_RELEASED modeS. 

Parameters: 

keycode - the key code. 

removeUserEvent(UserEvent) 

public void removeUserEvent (org. dvb . event . UserEvent event) 

Remove a user event from the repository. Removing a user event which is not in the repository shall 
have no effect. 

Parameters: 

event - the event to be removed from the repository. 
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org. dvb. event 

UserEventUnavailableEvent 



Declaration 

public class UserEventUnavailableEvent extends org . davic . resources . ResourceStatusEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I org . davic . resources .ResourceStatusEvent 

+ — org . dvb . event . UserEventUnavailableEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent to the resource status event hsteners when user input events are exclusively reserved by an 
application. 

Each application shall receive its own instance of the UserEvent Repository object which forms the source to 
this event. Any changes made to that repository by any one application shall not impact the instance seen by any 
other application. 

Any applications which have registered for shared access to any of these user events shall stop receiving those user 
events following receipt of this event. If such user events become available again, a 

UserEventAvailableEvent shall be generated by the platform before any more of those user events are 
received by applications. 

Since: 

MHP 1.0.2 



Constructors 



UserEventUnavailableEvent(Object) 

public UserEventUnavailableEvent (Java. lang. Object source) 

Constructor for the event. 

Parameters: 

source - a userEventRepository which contains the events which were exclusively 
reserved. 

Since: 

MHP 1.0.2 
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Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns a userEventRepository which contains the events which were exclusively reserved as 



passed into the constructor of the instance. 

Overrides: 

getSource in class ResourceStatusEvent 

Returns: 

a UserEventRepository 

Since: 

MHP 1.0.2 
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Annex K (normative): DVB-J persistent storage API 
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Package 

org.dvb.io.persistent 



Description 

Provides extensions to the java.io package for access to files held in persistent storage. 



Class Summary 


Classes 




FileAccess Permissions 


This class encapsulates file access permissions, world, Organisation and 




owner. 


FileAttributes 


This class encapsulates the attributes of a file stored in persistent storage. 
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org.dvb.io.persistent 

FileAccessPermissions 



Declaration 

public class FileAccessPermissions 
Java . lang .Object 

+ — org.dvb . io. persistent .FileAccessPermissions 

Description 

This class encapsulates file access permissions, world, Organisation and owner. World means all applications 
authorised to access persistent storage. Owner means the application which created the file. Organisation is defined 
as applications with the same organisation id as defined elsewhere in this specification. 



Constructors 



FileAccessPermissions(boolean, boolean, boolean, boolean, boolean, boolean) 

public FileAccessPermissions (boolean readWorldAccessRight, boolean writeWorldAccessRight, 
boolean readOrganisationAccessRight, boolean writeOrganisationAccessRight , 
boolean readApplicationAccessRight , boolean writeApplicationAccessRight ) 

This contructor encodes all the file access permissions as a set of booleans. 

Parameters: 

readWorldAccessRight - read access for all applications 

writeWorldAccessRight - write access for all applications 
readOrganisationAccessRight - read access for organisation 
writeOrganisationAccessRight - write access for organisation 
readApplicationAccessRight - read access for the owner 
writeApplicationAccessRight - write access for the owner 



Methods 

hasReadApplicationAccessRlghtO 

public boolean hasReadApplicationAccessRlghtO 

Query whether this permission includes read access for the owning application 

Returns: 

true if the owning application can have read access, otherwise false. 

hasReadOrganisationAccessRightO 

public boolean hasReadOrganisationAccessRight ( ) 

Query whether this permission includes read access for the organisation 
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Returns: 

true if applications in Ms organisation can iiave read access, otinerwise false. 



hasReadWorldAccessRightO 

public boolean hasReadWorldAccessRight ( ) 

Query whether this permission includes read access for the world. 

Returns: 

true if all applications can have read access, otherwise false. 

hasWriteApplicationAccessRightO 

public boolean hasWriteApplicationAccessRight ( ) 

Query whether this permission includes write access for the owning application 

Returns: 

true if the owning application can have write access, otherwise false. 

hasWriteOrganisationAccessRightO 

public boolean hasWriteOrganisationAccessRight ( ) 

Query whether this permission includes write access for the organisation 

Returns: 

true if applications in this organisation can have read access, otherwise false. 

hasWriteWorldAccessRightO 

public boolean hasWriteWorldAccessRight ( ) 

Query whether this permission includes write access for the world. 

Returns: 

true if all applications can have write access, otherwise false. 

setPermissions(boolean, boolean, boolean, boolean, boolean, boolean) 

public void setPermissions (boolean ReadWorldAccessRight , boolean WriteWorldAccessRight , 
boolean ReadOrganisationAccessRight, boolean WriteOrganisationAccessRight, 
boolean ReadApplicationAccessRight , boolean WriteApplicationAccessRight ) 

This method allows to modify the permissions on this instance of the FileAccessPermission class. 

Parameters: 

ReadWorldAccessRight - read access for all applications 

WriteWorldAccessRight - write access for all applications 
ReadOrganisationAccessRight - read access for organisation 
WriteOrganisationAccessRight - write access for organisation 
ReadApplicationAccessRight - read access for the owner 
WriteApplicationAccessRight - write access for the owner 
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org.dvb.io.persistent 

FileAttributes 



Declaration 

public class FileAttributes 
Java . lang .Object 

+ — org.dvb . io. persistent .FileAttributes 

Description 

This class encapsulates the attributes of a file stored in persistent storage. The default attributes for a file are low 
priority, owner read / write only permissions and null expiration date. 



Fields 

PRIORITY_HIGH 

public static final int PRIORITY_HIGH 

Value for use as a file priority. 
PRIORITY_LOW 

public static final int PRIORITY_LOW 

Value for use as a file priority. 
PRIORITY_MEDIUM 

public static final int PRIORITY_MEDIUM 

Value for use as a file priority. 



Methods 

getExpirationDateO 

public java.util .Date getExpirationDateO 

Returns the expiration date. It will return the value used by the platform, which need not be the same 
as the value set. 

Returns: 

the expiration date 
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getFileAttributes(File) 

public static org . dvb . io .persistent . FileAttributes getFileAttributes ( j ava . io . File f) 

throws lOException 

Get the attributes of a file. 

Parameters: 

f - tine file to use 

Returns: 

a copy of the attributes of a file 

Throws: 

j ava . lang . SecurityException - if the application is denied access to the file or to 
directories needed to reach the file by security policy 

j ava . io . lOException - if access to the file fails due to an 10 error or if the file reference is 
not to a valid location in persistent storage 



getPermissionsO 

public org . dvb . io .persistent . FileAccess Permissions getPermissions ( ) 

Returns the file access permissions 

Returns: 

the file access permissions 

getPriorityO 

public int getPriorityO 

Returns the priority to use in persistent storage 

Returns: 

the priority 

setExpirationDate(Date) 

public void setExpirationDate (j ava . util . Date d) 

Sets the expiration date. This field is a hint to the platform to identify the date after which a file is no 
longer useful as percieved by the application. The platform may choose to use a different date than 
the one given as a parameter. 

Parameters: 

d - the expiration date 

setFUeAttributes(FileAttributes, File) 

public static void setFileAttributes (org. dvb . io .persistent . FileAttributes p, 
Java. io. File f) 
throws lOException 

Associate a set of file attributes with a file. 

Parameters: 

p - the file attributes to use 

f - the file to use 
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Throws: 

j ava . lang . SecurityException - if the application is eitiner denied access to tiie file or 
directories needed to reach the file by security policy or is not authorised to modify the attributes 
of the file. 

j ava . io . lOException - if access to the file fails due to an 10 error or if the file reference is 
not to a valid location in persistent storage 



setPermissions(FileAccessPermissions) 

public void setPermissions (org . dvb . io .persistent . FileAccessPermissions p) 

Sets the file access permissions. 

Parameters: 

p - the file access permissions 

setPriority(int) 

public void setPriority (int priority) 

Sets the priority to use in persistent storage 

Parameters: 

priority - the priority to set 
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Annex L (normative): User Settings and Preferences 
API 



ETSI 



397 



ETSITS 101 812V1.3.1 (2003-06) 



Package 

org.dvb.user 



Description 

Provides access to settings and preferences configured by the end-user. 



Class Summary 


Interfaces 




UserPreference Change - 
Listener 


An application wisliing to be informed of any change to a user preference 
implements this interface. 


Classes 




Facility 


A facility maps a preference's name to a single value or to an array of values. 


General Preference 


This class defines a set of general preferences. 


Preference 


This abstract class defines the Preference object. 


UserPref erenceChan- 
geEvent 


This class defines the event sent to appropriate listeners when a user prefer- 
ence has been changed. 


UserPref erenceManager 


The UserPreferenceManager class gives access to the user preference set- 
tings. 


UserPref erence Permis- 
sion 


This class is for user preference and setting permissions. 


Exceptions 




UnsupportedPref eren- 
ceException 


Thrown when a non-supported preference is used. 
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org.dvb.user 

Facility 

Declaration 

public class Facility 
Java . lang .Object 

+ — org.dvb .user .Facility 

Description 

A facility maps a preference's name to a single value or to an array of values. A facility enables an application to 
define the list of values supported for a specified preference. For example, if an application is available in English 
or French then it can create a Facility ("User Language", {"English", "French"}). When the application will 
retrieve the "User Language" from the general preference it will specify the associated facility in order to get a 
Preference which will contain a set a values compatible with those supported by the application. 



Constructors 

Facility(String, String) 

public Facility (Java . lang . String preference, j ava . lang . String value) 

Creates a Facility witin a single value. This facility can be used by an application to retrieve a 
preference compatible with its capabilities. 

Parameters: 

preference - a String representing the name of the preference. 

value - a String representing the value of the preference. 
Facility(String, String[l) 

public Facility (Java . lang . String preference, Java . lang . String[ ] values) 

Creates a Facility with a set of values. This facility can be used by an application to retrieve a 
preference compatible with its capabilities. 

Parameters: 

preference - a String representing the name of the preference. 

values - an array of String representing the set of values. 
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org.dvb.user 

GeneralPreference 



Declaration 

public final class GeneralPreference extends Preference 

Java . lang .Object 

H org . dvb .user . Preference 

I 

+--org . dvb . user . GeneralPreference 

Description 

This class defines a set of general preferences. These preferences are read from the receiver and each application 
(downloaded or not) can access them through the UserPref erenceManager .read method. The standardized 
preferences are "User Language", "Parental Rating", "User Name", "User Address", "User @", "Country Code", 
"Default Font Size". 

When constructed, objects of this class are empty and have no values defined. Values may be added using the add 
methods inherited from the Preference class or by calling UserPref erenceManager . read. 

The encodings of these standardized preferences are as follows. 

• User Language: 3 letter ISO 639 language codes; 

• Parental Rating: string using the same encoding as returned by j avax . tv . service . guide . Content- 
Rat ingAdvis or y. getDisplayText; 

• User Name: Name of the user. This shall be in an order that is appropriate for presentation directly to the user, 
e.g. in Western Europe, listing the first name first and the family name last is recommended as being culturally 
appropriate in many locales. 

• User Address: postal address of the user, may contain multiple lines separated by carriage return characters (as 
defined in table D-4). 

• User @ : e-mail address of the user in the SMTP form as defined in RFC821 ; 

• Country Code: two letter ISO 3166-1 country code; 

• Default Font Size: preferred font size for normal body text expressed in points, decimal integer value encoded 
as a string (26 is the default; differing size indicates a preference of different font size than usual) 

The preference names are treated as case-insensitive. The preference names shall be considered equal at least when 
the method Java. lang. String. equalsIgnoreCaseO returns true for the strings when the locale "EN.UK" is used. 
Depending on the locale used in the implementation, implementations are allowed to consider equal also other 
upper and lower case character pairs in addition to those defined by the "EN.UK" locale. 

The standardized preference names in this specification shall only use such letters where the upper and lower case 
characters are recognized by the "EN.UK" locale. 

Constructors 

GeneralPreference(String) 

public GeneralPreference (j ava . lang . String name) 
throws IllegalArgumentException 

Constructs a GeneralPreference object. A general preference maps a preference name to a list of 
strings. 

Parameters: 

name - the general preference name. 

Throws: 

Java. lang. IllegalArgumentException - if the preference's name is not supported. 
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org.dvb.user 

Preference 



Declaration 

public abstract class Preference 
Java . lang .Object 

+ — org . dvb . user . Preference 

Direct Known Subclasses: 

GeneralPreference 

Description 

This abstract class defines the Preference object. A Preference maps a name to a list of favourite values. The first 
element in the list is the favourite value for this preference. 

The preference names are treated as case-insensitive. The preference names shall be considered equal at least when 
the method Java. lang. String. equalsIgnoreCaseO returns true for the strings when the locale "EN.UK" is used. 
Depending on the locale used in the implementation, implementations are allowed to consider equal also other 
upper and lower case character pairs in addition to those defined by the "EN.UK" locale. 

The standardized preference names in this specification shall only use such letters where the upper and lower case 
characters are recognized by the "EN.UK" locale. 

Constructors 

PreferenceO 

protected PreferenceO 

This protected constructor is only present to enable sub-classes of this one to be defined by the 
platform. It is not intended to be used by inter-operable applications. 

Preference(String, String) 

public Preference (j ava . lang. String name, Java . lang. String value) 

Creates a new preference with the specified name and the specified value. This single value will be 
the favourite one for this preference. 

Parameters: 

name - a String object representing the name of the preference. 

value - a String object representing the value of the preference. 



Preference(String, String!]) 

public Preference (j ava . lang. String name, j ava . lang . String[ ] value) 

Creates a new preference with the specified name and the specified value set. 

Parameters: 

name - a String object representing the name of the preference. 

value - an array of String objects representing the set of values for this preference ordered from 
the most favourite to the least favourite. 
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Methods 



add(int, String) 

public void add(int position, j ava . lang. String value) 

Adds a new value for this preference. The value is inserted at the specified position. If the value is 
already in the list then it is moved to the position specified. If the position is greater than the length of 
the list, then the value is added to the end of this list. If the position is negative, then the value is 
added to the beginning of this list. 



Parameters: 

position - an int representing the position in the list. 

value - a String representing the new value to insert. 



add(String) 

public void add (Java . lang . String value) 

Adds a new value for this preference. The value is added to the end of the list. If the value is already 
in the list then it is moved to the end of the list. 

Parameters: 

value - a String object representing the new value. 



add(String[l) 

public void add (Java . lang . String[ ] values) 

Adds several new values for this preferences. The values are added to the end of the list in the same 
order as they are found in the array passed to this method. Any values already in the list are moved 
to the position in the list which they would have if they were not already present. 

Parameters: 

values - an array of strings representing the values to add 

Since: 

MHP 1.0.1 



getFavouritesO 

public Java. lang. String[ ] getFavouritesO 

Returns the list of favourite values for this preference. Returns an empty array if no value sets are 
defined for this preference. 

Returns: 

an array of String representing the favourite values for this preference. 

getMostFavouriteO 

public j ava . lang. String getMostFavouriteO 

Returns the most favourite value for this preference, that is, the first element of the list. 

Returns: 

a String representing the favourite values Returns null if no value is defined for this preference. 
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getNameO 

public j ava . lang. String getName ( ) 

Returns the name of the preference. 

Returns: 

a String object representing the name of the preference. 



getPosition(String) 

public int getPosition (j ava . lang . String value) 

Returns the position in the list of the specified value. 

Parameters: 

value - a String representing the value to look for. 

Returns: 

an integer representing the position of the value in the list counting from zero. If the value is not 
found then it returns -1 . 



hasValueO 

public boolean hasValue ( ) 

Tests if this preference has at least one value set. 

Returns: 

true if this preference has at least one value set, false otherwise. 

remove(String) 

public void remove (j ava . lang . String value) 

Removes the specified value from the list of favourites. If the value is not in the list then the method 
call has no effect. 

Parameters: 

value - a String representing the value to remove. 

removeAUO 

public void removeAUO 

Removes all the values of a preference 

Since: 

MHP 1.0.1 



setMostFavourite(String) 

public void setMostFavourite (j ava . lang . String value) 

Sets the most favourite value for this preference. If the value is already in the list, then it is moved to 
the head. If the value is not already in the list then it is added at the head. 

Parameters: 

value - the most favourite value 
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toStringO 

public j ava . lang. String toString ( ) 

Convert name and favourites to a String. 

Overrides: 

toString in class Object 

Returns: 

tine preference name and favourites 
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org.dvb.user 

UnsupportedPreferenceException 



Declaration 

public class UnsupportedPreferenceException extends Java . lang . Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . dvb . user . UnsupportedPreferenceException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Thrown when a non-supported preference is used. 



Constructors 

UnsupportedPreferenceExceptionO 

public UnsupportedPreferenceException () 

Constructs a UnsupportedPreferenceException with no detail message. 

UnsupportedPreferenceException(String) 

public UnsupportedPreferenceException (j ava . lang. String a) 

Constructs a UnsupportedPreferenceException witin a detail message. 

Parameters: 

a - the detail message 
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org.dvb.user 

UserPreferenceChangeEvent 



Declaration 

public class UserPreferenceChangeEvent extends j ava . util .EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+--org . dvb . user . UserPreferenceChangeEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This class defines ttie event sent to appropriate listeners when a user preference has been changed. 



Constructors 

UserPreferenceChangeEvent(String) 

public UserPreferenceChangeEvent ( j ava .lang. String preferenceName) 

Constructs a new event. 

Parameters: 

preferenceName - the name of the modified preference. 



Methods 

getNameO 

public Java . lang. String getNameO 

Returns the name of the modified Preference 

Returns: 

the Preference name. 
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org.dvb.user 

UserPreferenceChangeListener 



Declaration 

public interface UserPreferenceChangeListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

An application wishing to be informed of any change to a user preference implements this interface. 



Methods 

receiveUserPreferenceChangeEvent(UserPreferenceChangeEvent) 

public void receiveUserPreferenceChangeEvent (org . dvb . user . UserPreferenceChangeEvent e) 

This method is called when a user preference changes. 

Parameters: 

e - the event notifying this event. 
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org.dvb.user 

UserPreferenceManager 

Declaration 

public class UserPreferenceManager 
Java . lang .Object 

+ — org . dvb . user . UserPreferenceManager 

Description 

The UserPreferenceManager class gives access to the user preference settings. This class provides a set of methods 
that allow an application to read or save user settings. It also provides a mechanism to notify applications when a 
preference has been modified. The value of a user setting,retrieved with the read method, is a copy of the value that 
is stored in the receiver. The write method, if authorized, overwrites the stored value. 

When end-user preferences are read into a Preference object from the MHP terminal, the ordering of these 
values shall be as determined by the end-user, from most preferred to least preferred to the extent that this is 
known. 

NOTE: MHP implementations are not required to validate the values in Preference objects, even those which are 
saved using the write method. Applications with write permissions need to be very careful that the values written 
are valid. Applications reading permissions need to be aware of the possibility that a previous application has set an 
invalid value. 



Methods 

addUserPreferenceChangeListener(UserPreferenceChangeListener) 

public void addUserPreferenceChangeListener (org. dvb . user .UserPreferenceChangeListener 1) 

Adds a listener for changes in user preferences. 

Parameters: 

1 - tine listener to add. 

getlnstanceO 

public static org . dvb . user .UserPreferenceManager getlnstanceO 

Return an instance of the UserPreferenceManager for this application. Repeated calls to this 
method by the same application shall return the same instance. 

Returns: 

an instance of UserPreferenceManager 

read(Preference) 

public void read (org . dvb . user . Preference p) 

Allows an application to read a specified user preference. 

Parameters: 

p - an object representing the preference to read. 
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Throws: 

j ava . lang . SecurityException - if the calling application is denied access to this 
preference 



read(Preference, Facility) 

public void read (org . dvb . user . Preference p, org. dvb . user . Facility facility) 

Allows an application to read a specified user preference taking into account the facility defined by 
the application. After this method returns, the values in the Preference object shall be the values 
of that user preference with any unsupported values from the Facility removed from that list. Note 
that the order of values returned here need not be the same as that returned by 

read (Preference) . 

If the intersection between the two sets of values is empty then the preference will have no value. If 
there is a mis-match between the name of the preference used when constructing the facility and the 
name of the preference used in this method then the preference will have no value. 

Parameters: 

p - an object representing the preference to read. 

facility - the preferred values the application for the preference 

Throws: 

j ava . lang . SecurityException - if the calling application is denied access to this 
preference 



removeUserPreferenceChangeListener(UserPreferenceChangeListener) 

public void removeUserPreferenceChangeListener (org. dvb . user .UserPreferenceChangeListener 1) 

Removes a listener for changes in user preferences. 

Parameters: 

1 - the listener to remove. 

write(Preference) 

public void write (org . dvb . user . Preference p) 

throws UnsupportedPreferenceException, lOException 

Saves the specified user preference. If this method succeeds then it will change the value of this 
preference for all future MHP applications. 

Parameters: 

p - the preference to save. 

Throws: 

UnsupportedPreferenceException - if the preference provided is not a standardized 
preference as defined for use with GeneraiPref erence. 

j ava . lang . SecurityException - if the application does not have permission to call this 
method 

j ava . io . lOException - if saving the preference fails for other I/O reasons 
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org.dvb.user 

UserPreferencePermission 



Declaration 

public class UserPreferencePermission extends j ava . security . BasicPermission 

Java . lang .Object 

H j ava . security. Permission 

I 

-I Java .security. BasicPermission 

+ — org . dvb . user . UserPreferencePermission 

All Implemented Interfaces: 

j ava .security. Guard, j ava .io.Serializable 

Description 

This class is for user preference and setting permissions. A UserPreferencePermission contains a name, but no 
actions list. 

The permission name can either be "read" or "write". The "read" permission allows an application to read the user 
preferences and settings (using UserPref erenceManager . read) for which read access is not always 
granted. Access to the following settings/preferences is always granted: "User Language", "Parental Rating", 
"Default Font Size" and "Country Code" 

The "write" permission allows an application to modify user preferences and settings (using 

UserPref erenceManager . write). 



Constructors 

UserPreferencePermission(String) 

public UserPreferencePermission (Java . lang . String name) 

Creates a new UserPreferencePermission with the specified name. Tine name is tine symbolic name 
of tine UserPreferencePermission. 

Parameters: 

name - tine name of tine UserPreferencePermission 

UserPreferencePermission(String, String) 

public UserPreferencePermission (Java . lang . String name, Java . lang . String actions) 

Creates a new UserPreferencePermission object witin tine specified name. Tine name is tine symbolic 
name of the UserPreferencePermission, and the actions String is unused and should be null. This 
constructor exists for use by the Policy object to instantiate new Permission objects. 

Parameters: 

name - the name of the UserPreferencePermission 

actions - should be null. 
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Annex M (normative): SI Access API 
M.1 Unicode 

References to "Unicode" in the following API description shall be interpreted as references to ISO 10646-1 [18]. 
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Package 

org.dvb.si 



Description 

Provides access to DVB service information. 

General Design 

Many of the methods in this package use a common design template. Asynchronous method calls to retrieve data 
from the network all return an instance of the SIRequest class. Applications may use this to inquire about or 
terminate the retrieval operation. When the retrieval operation completes, an instance of a subclass of 
SIRetrievalEvent will be sent to the SIRetrievalListener which the application passed in as a 
parameter to the original method call to retrieve data from the network. When constructing these events, the 
platform shall provide as the request parameter to the event constructor, the same instance of the SIRequest 
class as was returned by the original method call which started the retrieval operation. This SIRequest instance 
shall be returned by the getSource method on such events. 



Class Summary 



Interfaces 

DescriptorTag 

PMTElementaryStream 

PMTService 

PMTStreamType 

SIBouquet 

SIEvent 

SI Information 

Sllterator 

SIMonitoringListener 
SIMonitoringType 
SINetwork 

SIRetrievalListener 

SIRunningStatus 

SIService 



This interface defines constants corresponding to the most common descriptor 
tags. 

This Interface represents an elementary stream of a service. 

This Interface represents a particular service carried by a transport stream. 

This Interface defines the constants corresponding to the different stream 
types 

This Interface (together with the SITransportStreamBAT interface) represents a 
sub-table of the Bouquet Association Table (BAT) describing a particular bou- 
quet. 

This Interface represents a particular event within a service. 

This Interface groups the common features of SIBouquet, SINetwork, 
SITransportStream, SIService, PMTService, SIEvent, SITime and 
PIVlTEIementaryStream. 

Objects Implementing Sllterator interface allow to browse through a set of SI 
objects. 

This interface shall be Implemented by using application classes In order to lis- 
ten to changes in monitored SI objects. 

This interface defines the constants corresponding to the SI information type 
values in SIMonitoringEvent. 

This Interface (together with the SITransportStreamNIT Interface) represents a 
sub-table of the Network Information Table (NIT) describing a particular net- 
work. 

This Interface shall be implemented by application classes In order to receive 
events about completion of SI requests. 

This Interface defines the constants corresponding to the running status values 
for services and events. 

This Interface represents a particular service carried by a transport stream. 



ETSI 



412 



ETSITS 101 812V1.3.1 (2003-06) 



Class Summary 



SIServiceType 
SITime 

SITransportStream 

SITransportStreamBAT 

SITransportStreamDe- 
scription 

SITransportStreamNIT 

Textual Service Identi- 
f ierQuery 

Classes 

Descriptor 

SIDatabase 

SILackOf Re sources Ev- 
ent 

SIMonitoringEvent 
SINotlnCacheEvent 



SIObjectNotlnT- 
ableEvent 



SIRequest 



S I Re que St Can cell edE- 
vent 

SIRetrievalEvent 



SISuccessfulRe- 
trieveEvent 

SITableNotFoundEvent 



SITableUpdatedEvent 



SlUtil 

Exceptions 

SIException 

SIIllegalArgumentEx- 
ception 



This interface defines constants corresponding to tlie different service types. 

This interface represents the Time and Date Table (TDT) and the (optional) 
Time Offset Table (TOT). 

This interface is the base interface for representing information about transport 
streams. 

This interface represents information about transport streams that has been 
retrieved from a BAT table. 

This interface represents the Transport Stream Description Table (TSDT). 

This interface represents information about transport streams that has been 
retrieved from a NIT table. 

An interface that can be implemented by objects representing DVB services. 



This class represents a descriptor within a sub-table. 

This class represents the root of the SI information hierarchy. 

This event is sent in response to a SI retrieval request when the resources 
needed for retrieving the data are not available, e.g. 

Objects of this class are sent to listener objects of the using application to 
notify that a change in the monitored information has happened. 

This event is sent in response to a SI retrieval request when the request was 
made with the FROM_GACHE_ONLY mode and the requested data is not 
present in the cache. 

This event is sent in response to a SI retrieval request when the SI table where 
the information about the requested object should be located has been 
retrieved but the requested object is not present in it. 

Object instances of this class represent SI retrieval requests made by the 
application. 

This event is sent in response to a SI retrieval request when the request is can- 
celled with the SIRequest.cancelRequest method call. 

This class is the base class for events about completion of a SI retrieval 
request. 

This event is sent in response to a SI retrieval request when the retrieve 
request was successfully completed. 

This event is sent in response to a SI retrieval request when the SI table that 
should contain the requested information could not be retrieved. 

This event is sent in response to a SI descriptor retrieval request when the 
table carrying the information about the object has been updated and the set of 
descriptors consistent with the old object can not be retrieved. 

This class contains SI related utility functions. 



This class is the root of the SI exceptions hierarchy. 

This exception is thrown when one or more of the arguments passed to a 
method are invalid (e.g. 
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Class Summary 



siinvaiidPeriodExcep- jhis exception is thrown wlien a specified period is invalid (for example, start 
tion tjmg jg after the end time) 
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org.dvb.si 

Descriptor 

Declaration 

public class Descriptor 
Java . lang .Object 

+ — org . dvb . si . Descriptor 

Description 

This class represents a descriptor within a sub-table. 

A descriptor consist of three fields: a tag, a contentLength and the content. 

The tag uniquely identifies the descriptor type. The content length indicates the number of bytes in the content. The 
content consists of an array of bytes of length content length. The data represented by the content is descriptor type 
dependent. 

See Also: 

DescriptorTag 



Constructors 

DescriptorO 

protected DescriptorO 

This constructor is provided for tiie use of implementations and specifications wiiicii extend tinis 
specification. Applications shall not define sub-classes of this class. Implementations are not 
required to behave correctly if any such application defined sub-classes are used. 



Methods 



getByteAt(int) 

public byte getByteAt (int index) 

throws IndexOutOfBoundsException 

Get a particular byte within the descriptor content 

Parameters: 

index - index to the descriptor content. Value corresponds to the first byte after the length 
field. 

Returns: 

The required byte 

Throws: 

j ava . lang . IndexOutOfBoundsException - if index < or index >= ContentLength 
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getContentQ 

public bYte[] getContent ( ) 

Get a copy of the content of this descriptor (everything after the length field). 

Returns: 

a copy of the content of the descriptor 

getContentLengthQ 

public short getContentLength { ) 

This method returns the length of the descriptor content as coded in the length field of this 



descriptor. 

Returns: 

The length of the descriptor content. 



getTagO 

public short getTag () 

Get the descriptor tag. The value returned shall be the actual value used and is not limited to the 
values defined in DescriptorTag. 

Returns: 

The descriptor tag (the most common values are defined in the DescriptorTag interface) 

See Also: 

DescriptorTag 
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org.dvb.si 

DescriptorTag 



Declaration 

public interface DescriptorTag 

Description 

This interface defines constants corresponding to the most common descriptor tags. 

See Also: 

Descriptor 



Fields 

BOUQUET_NAME 

public static final short BOUQUET_„NAME 

Constant value for the descriptor tag as specified in EN 300 468 
CAJDENTIFIER 

public static final short CA_IDENTIFIER 

Constant value for the descriptor tag as specified in EN 300 468 
CABLE_DELIVERY_SYSTEM 

public static final short CABLE_DELIVERY_SYSTEM 

Constant value for the descriptor tag as specified in EN 300 468 
COMPONENT 

public static final short COMPONENT 

Constant value for the descriptor tag as specified in EN 300 468 
CONTENT 

public static final short CONTENT 

Constant value for the descriptor tag as specified in EN 300 468 
COUNTRY_AVAIL ABILITY 

public static final short COUNTRY_AVAILABILITY 

Constant value for the descriptor tag as specified in EN 300 468 
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DATA_BROADCAST 

public static final short DATA_BROADCAST 

Constant value for the descriptor tag as specified in EN 300 468 
EXTENDED_EVENT 

public static final short EXTENDED_EVENT 

Constant value for the descriptor tag as specified in EN 300 468 
FREQUENCY_LIST 

public static final short FREQUENCY_LIST 

Constant value for the descriptor tag as specified in EN 300 468 
LINKAGE 

public static final short LINKAGE 

Constant value for the descriptor tag as specified in EN 300 468 
LOCAL_TIME_OFFSET 

public static final short LOCAL_TIME_OFFSET 

Constant value for the descriptor tag as specified in EN 300 468 
MOSAIC 

public static final short MOSAIC 

Constant value for the descriptor tag as specified in EN 300 468 
MULTILINGUAL_BOUQUET_NAME 

public static final short MULTILINGUAL_BOUQUET_NAME 

Constant value for the descriptor tag as specified in EN 300 468 
MULTILINGUAL_COMPONENT 

public static final short MULTILINGUAL_COMPONENT 

Constant value for the descriptor tag as specified in EN 300 468 
MULTILINGUAL_NETWORK_NAME 

public static final short MULTILINGUAL_NETWORK_NAME 

Constant value for the descriptor tag as specified in EN 300 468 
MULTILINGUAL_SERVICE_NAME 

public static final short MULTILINGUAL_SERVICE_NAME 

Constant value for the descriptor tag as specified in EN 300 468 
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NETWORK_NAME 

public static final short NETWORK_NAME 

Constant value for the descriptor tag as specified in EN 300 468 
NVOD_REFERENCE 

public static final short NVOD_REFERENCE 

Constant value for the descriptor tag as specified in EN 300 468 
PARENTAL_RATING 

public static final short PARENTAL_RATING 

Constant value for the descriptor tag as specified in EN 300 468 
PARTIAL_TRANSPORT_STREAM 

public static final short PARTIAL_TRANSPORT_STREAM 

Constant value for the descriptor tag as specified in EN 300 468 
PRIVATE_DATA_SPECIFIER 

public static final short PRIVATE_DATA_SPECIFIER 

Constant value for the descriptor tag as specified in EN 300 468 
SATELLITE_DELIVERY_SYSTEM 

public static final short SATELLITE_DELIVERY_SYSTEM 

Constant value for the descriptor tag as specified in EN 300 468 
SERVICE 

public static final short SERVICE 

Constant value for the descriptor tag as specified in EN 300 468 
SERVICE_LIST 

public static final short SERVICE_LIST 

Constant value for the descriptor tag as specified in EN 300 468 
SERVICE_MOVE 

public static final short SERVICE_MOVE 

Constant value for the descriptor tag as specified in EN 300 468 
SHORT_EVENT 

public static final short SHORT_EVENT 

Constant value for the descriptor tag as specified in EN 300 468 



ETSI 



419 ETSITS 101 812V1.3.1 (2003-06) 



SHORT_SMOOTHING_BUFFER 

public static final short SHORT_SMOOTHING_BUFFER 

Constant value for the descriptor tag as specified in EN 300 468 
STREAMJDENTIFIER 

public static final short STREAM_IDENTIFIER 

Constant value for the descriptor tag as specified in EN 300 468 
STUFFING 

public static final short STUFFING 

Constant value for the descriptor tag as specified in EN 300 468 
SUBTITLING 

public static final short SUBTITLING 

Constant value for the descriptor tag as specified in EN 300 468 
TELEPHONE 

public static final short TELEPHONE 

Constant value for the descriptor tag as specified in EN 300 468 
TELETEXT 

public static final short TELETEXT 

Constant value for the descriptor tag as specified in EN 300 468 
TERRESTRIAL_DELIVERY_SYSTEM 

public static final short TERRESTRIAL_DELIVERY_SYSTEM 

Constant value for the descriptor tag as specified in EN 300 468 
TIME_SHIFTED_EVENT 

public static final short TIME_SHIFTED_EVENT 

Constant value for the descriptor tag as specified in EN 300 468 
TIME_SHIFTED_SERVICE 

public static final short TIME_SHIFTED_SERVICE 

Constant value for the descriptor tag as specified in EN 300 468 
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org.dvb.si 

PMTEIementaryStream 



Declaration 

public interface PMTEIementaryStream extends Sllnformation 

All Superinterfaces: 

Sllnformation 

Description 

This interface represents an elementary stream of a service. 

For each running service there is a PMT describing the elementary streams of the service. An object that 
implements this interface represents one such elementary stream. Each object that implements the 
PMTEIementaryStream interface is identified by the combination of the identifiers original_network_id, 
transport_stream_id, service_id, component_tag (or elementary _PID). 

See Also: 

PMTService, PMTStreamType 



Methods 

getComponentTagO 

public int getComponentTagO 

Get the component tag identifier. 

Returns: 

Tine component tag. If tiie elementary stream does not have an associated component tag, this 
method returns -2. 

getDvbLocatorQ 

public org.davic. net . dvb. DvbLocator getDvbLocator ( ) 

Gets a DvbLocator that identifies this elementary stream 

Returns: 

The DvbLocator of this elementary stream 

getElementaryPIDQ 

public short getElementaryPID ( ) 

Get the elementary PID. 

Returns: 

The PID the data of elementary stream is sent on in the transport stream. 
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getOriginalNetworklDO 

public int getOriginalNetworkID ( ) 

Get the original networl< identification identifier. 

Returns: 

The original network identification. 



getServicelDQ 

public int getServicelD ( ) 

Get the service identification identifier. 

Returns: 

The service identification. 



getStreamXypeO 

public byte getStreamType ( ) 

Get the stream type of this elemetary stream. The value returned shall be the actual value from the 
descriptor loop and is not limited to the set of values defined in PMTStreamType. 

Returns: 

The stream type (some of the possible values are defined in the PMTStreamType interface). 

See Also: 

PMTStreamType 



getXransportStreamlDO 

public int getTransportStreamID ( ) 

Get the transport stream identification identifier. 

Returns: 

The transport stream identification. 
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org.dvb.si 

PMTService 



Declaration 

public interface PMTService extends SI Information 

All Superinterfaces: 

SI Information 

Description 

This interface represents a particular service carried by a transport stream. The information is retrieved from the 
PMT table. 

Each object that implements the PMTService interface is identified by the combination of the following identifiers: 
original_network_id, transport_stream_id, service_id. 



Methods 

getDvbLocatorQ 

public org . davic. net . dvb . DvbLocator getDvbLocator ( ) 

Gets a DvbLocator that identifies tinis service 

Returns: 

Tiie DvbLocator of tin is service 

getOriginalNetworklDQ 

public int getOriginalNetworkID ( ) 

Get tine original networl< identification. 

Returns: 

The original network identification identifier. 

getPcrPidO 

public int getPcrPidO 

Get the PCRpid. 

Returns: 

The PCR pid. 

getServicelDQ 

public int getServicelD ( ) 

Get the service identification. 

Returns: 

The service identification identifier. 
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getTransportStreamlDO 

public int getTransportStreamlDO 

Get the transport stream identification. 

Returns: 

The transport stream identification identifier. 



retrievePMTElementaryStreams(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrievePMTElementaryStreams (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] somePMTDescriptorTags) 
throws SI IllegalArgument Except ion 

Retrieve information associated witin tine elementary streams winicin compose this service from the 
Program IVIap Table (PMT). 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the PMTEIementaryStream interface. If no matching object was 
found, the appropriate one of the following events is sent: SIObjectNotlnCacheEvent 
SIObjectNotlnTableEvent or SITableNotFoundEvent. This method will retrieve 
PMTEIementaryStreams from the same sub-table version as this PMTService instance. If this 
version of the sub-table is no longer available, an SITableUpdatedEvent is returned. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

somePMTDescriptorTags - A list of hints for descriptors (identified by their tags) the 
application is interested in. If the array contains -1 as its one and only element, the application is 
interested in all descriptors. If somePMTDescriptorTags is null, the application is not interested in 
descriptors. All non applicable tag values are ignored. 

Returns: 

An SIRequest object 

Throws: 

SllllegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, PMTEIementaryStream 
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org.dvb.si 

PMTStreamType 



Declaration 

public interface PMTStreamType 

Description 

This interface defines the constants corresponding to the different stream types 

See Also: 

PMTElementaryStream, PMTElementaryStream. getStreamType () 



Fields 

MPEGl_AUDIO 

public static final byte MPEGl_AUDIO 

Constant value for the stream type as specified in ISO/IEC 13818-1 
MPEGl_VIDEO 

public static final byte MPEG1_VIDE0 

Constant value for the stream type as specified in ISO/IEC 13818-1 
MPEG2_AUDIO 

public static final byte MPEG2_AUDI0 

Constant value for the stream type as specified in ISO/IEC 13818-1 
MPEG2_VIDEO 

public static final byte MPEG2_VIDE0 

Constant value for the stream type as specified in ISO/IEC 13818-1 
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org.dvb.si 

SIBouquet 



Declaration 

public interface SIBouquet extends Sllnformation 

All Superinterfaces: 

Sllnformation 

Description 

This interface (together with the SITransportStreamBAT interface) represents a sub-table of the Bouquet 
Association Table (BAT) describing a particular bouquet. 

Each object that implements the SIBouquet interface is identified by the identifier bouquet_id. 
See Also: 

SITransportStreamBAT 



Methods 



getBouquetlDO 

public int getBouquetlDO 

Get the identification. 

Returns: 

Tiie bouquet identification of tinis bouquet. 



getDescriptorTagsO 

public short [] getDescriptorTagsO 

Tiiis metiiod defines extra semantics for tine SI Information. getDescriptorTags method. If the BAT 
sub-table on which this SIBouquet object is based consists of multiple sections, then this method 
returns the descriptor tags in the order they appear when concatenating the descriptor loops of the 
different sections. 

Overrides: 

getDescriptorTags in interface Sllnformation 

Returns: 

The tags of the descriptors actually broadcast for the object (identified by their tags). 

See Also: 

Sllnformation, Sllnformation . getDescriptorTags () 
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getNameO 

public Java. lang. String getNameO 

This method returns the name of this bouquet. If the language returned by 
javax . tv. service . SIManager.getPreferredLanguage is one of those in the 
multilingual_bouquet_name_descriptor, return the name in that language, otherwise return an 
implementation dependent selection between the names in the 

multilinguaLbouquet_name_descriptor and the name in the bouquet_name_descriptor. When this 
information is not available "" is returned. All control characters as defined in ETR 211 are ignored. 
For each character the DVB-SI 8 bit character code is mapped to the appropriate Unicode 
representation 



Returns: 

The bouquet name of this bouquet. 



getShortBouquetNameO 

public Java . lang. String getShortBouquetName ( ) 

This method returns the short name (ETR 211) of this bouquet without emphasis marks. If the 
language returned by javax. tv. service . SIManager.getPreferredLanguage is one of 
those in the multilingual_bouquet_name_descriptor, return the name in that language, otherwise 
return an implementation dependent selection between the names in the 
multilingual_bouquet_name_descriptor and the name in the bouquet_name_descriptor. If the 
descriptor is not present, "" is returned. If the string can be found but does not contain control codes 
for abbreviating it, the full string shall be returned. For each character the DVB-SI 8 bit character 
code is mapped to the appropriate Unicode representation. 

Returns: 

The short bouquet name of this bouquet. 



getSIServiceLocatorsO 

public org.davic. net . dvb. DvbLocator[ ] getSIServiceLocatorsO 

Get a list of DvbLocators identifying the services that belong to the bouquet. 

Returns: 

An array of DvbLocators identifying the services 

See Also: 

org . davic . net . dvb . DvbLocator, SIService 



retrieveDescriptors(short, Object, SIRetrievalListener) 

public org . dvb . si . SIRequest retrieveDescriptors (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener) 
throws SI IllegalArgument Except ion 

This method defines extra semantics for the Sllnformation. retrieveDescriptors method (first 
prototype). If the BAT sub-table on which this SIBouquet object is based consists of multiple 
sections, then this method returns the requested descriptors in the order they appear when 
concatenating the descriptor loops of the different sections. 

Overrides: 

retrieveDescriptors in interface Sllnformation 
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Parameters: 

retrieveMode - Mode of retrieval indicating winetlner the data sinould be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

Returns: 

An SI Request object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SI Information, SI In format ion . retrieveDescriptors (short, Object, 
SIRetrievalListener) 



retrieveDescriptors(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveDescriptors (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SiillegalArgumentException 

This method defines extra semantics for the Sllnformation. retrieveDescriptors method (second 
prototype). If the BAT sub-table on which this SIBouquet object is based consists of multiple 
sections, then this method returns the requested descriptors in the order they appear when 
concatenating the descriptor loops of the different sections. 

Overrides: 

retrieveDescriptors in interface Sllnformation 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of tags for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the behaviour is implementation dependent. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

Sllnformation, Sllnformation . retrieveDescriptors (short. Object, 
SIRetrievalListener, short[ ] ) 
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retrieveSIBouquetTransportStreams(short, Object, SIRetrievalListener, short[]) 

public org.dvb. si . SIRequest retrieveSIBouquetTransportStreams (short retrieveMode, 
j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SI Illegal Argument Except ion 

Retrieve information associated witin transport streams belonging to tlie bouquet. 

Tiie Sllterator that is returned witii tine event wiien tlie request completes successfully will contain 
one or more objects that implement the SITransportStreamBAT interface. This method will retrieve 
SIBouquetTransportStreams from the same sub-table version as this SIBouquet instance. If this 
version of the sub-table is no longer available, an SITableUpdatedEvent is returned. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the behaviour is implementation dependent. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SITransportStreamBAT, DescriptorTag 
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org.dvb.si 

SI Database 



Declaration 

public class SIDatabase 
Java . lang .Object 

+ — org . dvb . si . SIDatabase 

Description 

This class represents the root of the SI information hierarchy. There is one SIDatabase per network interface. In a 
system with a single network interface there is only one SIDatabase object. 

When adding a listener to monitor for changes in an SI table (or data carried in an SI table), an event shall not be 
generated for the current version of that table (or data) found in the network at the time the listener is added. Events 
shall only be generated for changes following the detection of that current version. 



Constructors 

SIDatabaseO 

protected SIDatabaseO 

This constructor is provided for the use of implementations and specifications which extend this 
specification. Applications shall not define sub-classes of this class. Implementations are not 
required to behave correctly if any such application defined sub-classes are used. 



Methods 



addBouquetMonitoringListener(SIMonitoringListener, int) 

public void addBouquetMonitoringListener (org . dvb . si . SIMonitoringListener listener, 
int bouquetid) 
throws SI I lie gal Argument Except ion 

Initiate monitoring of the bouquet information. When the bouquet information changes, an event will 
be delivered to the registered listener object. 

How the monitoring is performed is implementation dependent and especially does not necessarily 
need to be continuous. The event will be delivered as soon as the implementation notices the change 
which might have some delay relative to when the change was actually made in the stream due to 
resources for the monitoring being scheduled between the monitoring activities of different tables. 
This specification does not set any minimum requirements for monitoring of the SI tables. This is to 
be done at a best effort basis by the implementation and is entirely implementation dependent. The 
only requirement is that when an implementation detects a change, e.g. because a resident 
Navigator or an MHP application has retrieved some SI information from the stream, then these 
listeners are notified of the change. 

The monitoring stops silently and permanently when the network interface with which this 
SIDatabase object is associated starts tuning to another transport stream. 
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Parameters: 

listener - listener object that will receive events when a change in the information is detected. 

bouquetid - bouquet identifier of the bouquet whose information will be monitored. 

Throws: 

SiillegalArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 

addEventPresentFollowingMonitoringListener(SIMonitoringListener, int, int, int) 

public void addEventPresentFollowingMonitoringListener (org . dvb . si . SIMonitoringListener 
listener, int originalNetworkId, int transportStreamId, int serviceld) 
throws SiillegalArgumentException 

Initiate monitoring of information in the EIT related to present and following events. When the 
information related to those events changes, an event will be delivered to the registered listener 
object. 

The scope of the monitoring is determined by the original network identifier, transport stream 
identifier and service identifier. The listener will be notified about the change of the information in any 
present and following event within that scope. 

How the monitoring is performed is implementation dependent and especially does not necessarily 
need to be continuous. The event will be delivered as soon as the implementation notices the change 
which might have some delay relative to when the change was actually made in the stream due to 
resources for the monitoring being scheduled between the monitoring activities of different tables. 
This specification does not set any minimum requirements for monitoring of the SI tables. This is to 
be done at a best effort basis by the implementation and is entirely implementation dependent. The 
only requirement is that when an implementation detects a change, e.g. because a resident 
Navigator or an MHP application has retrieved some SI information from the stream, then these 
listeners are notified of the change. 

The monitoring stops silently and permanently when the network interface with which this 
SIDatabase object is associated starts tuning to another transport stream. 

Parameters: 

listener - listener object that will receive events when a change in the information is detected. 

originalNetworkId - original network identifier specifying the scope of the monitoring. 
transportStreamId - transport stream identifier specifying the scope of the monitoring. 
serviceld - service identifier specifying the scope of the monitoring 

Throws: 

SiillegalArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 

addEventScheduleMonitoringListener(SIMonitoringListener, int, int, int. Date, Date) 

public void addEventScheduleMonitoringListener (org . dvb . si . SIMonitoringListener listener, 
int originalNetworkId, int transportStreamId, int serviceld, 
j ava . util . Date startTime, Java .util . Date endTime) 
throws SiillegalArgumentException, SIInvalidPeriodException 

Initiate monitoring of information in the EIT related to scheduled events. When the information 
related to those events changes, an event will be delivered to the registered listener object. 
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The scope of the monitoring is determined by the original networl< identifier, transport stream 
identifier, service identifier, start time and end time of the schedule period. The listener will be 
notified about the change of the information in any scheduled event within that scope. 

How the monitoring is performed is implementation dependent and especially does not necessarily 
need to be continuous. The event will be delivered as soon as the implementation notices the change 
which might have some delay relative to when the change was actually made in the stream due to 
resources for the monitoring being scheduled between the monitoring activities of different tables. 
This specification does not set any minimum requirements for monitoring of the SI tables. This is to 
be done at a best effort basis by the implementation and is entirely implementation dependent. The 
only requirement is that when an implementation detects a change, e.g. because a resident 
Navigator or an MHP application has retrieved some SI information from the stream, then these 
listeners are notified of the change. 

The monitoring stops silently and permanently when the network interface with which this 
SIDatabase object is associated starts tuning to another transport stream. 

Parameters: 

listener - listener object that will receive events when a change in the information is detected. 

originalNetworkid - original network identifier specifying the scope of the monitoring. 
transportstreamid - transport stream identifier specifying the scope of the monitoring. 
serviceid - service identifier specifying the scope of the monitoring 
startTime - Start time of the schedule period 
endTime - end time of the schedule period 

Throws: 

siiiiegaiArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

SiinvalidPeriodException - thrown if end time is before start time 

See Also: 

SIMonitoringListener, SIMonitoringEvent 

addNetworkMonitoringListener(SIMonitoringListener, int) 

public void addNetworkMonitoringListener (org . dvb . si . SIMonitoringListener listener, 
int networkid) 
throws SiiiiegaiArgumentException 

Initiate monitoring of the network information. When the network information changes, an event will 
be delivered to the registered listener object. 

How the monitoring is performed is implementation dependent and especially does not necessarily 
need to be continuous. The event will be delivered as soon as the implementation notices the change 
which might have some delay relative to when the change was actually made in the stream due to 
resources for the monitoring being scheduled between the monitoring activities of different tables. 
This specification does not set any minimum requirements for monitoring of the SI tables. This is to 
be done at a best effort basis by the implementation and is entirely implementation dependent. The 
only requirement is that when an implementation detects a change, e.g. because a resident 
Navigator or an MHP application has retrieved some SI information from the stream, then these 
listeners are notified of the change. 

The monitoring stops silently and permanently when the network interface with which this 
SIDatabase object is associated starts tuning to another transport stream. 

Parameters: 

listener - listener object that will receive events when a change in the information is detected. 

networkid - network identifier of the network whose information will be monitored. 
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Throws: 

siiiiegaiArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 



addPMTServiceMonitoringListener(SIMonitoringListener, int, int, int) 

public void addPMTServiceMonitoringListener (org. dvb . si . SIMonitoringListener listener, 
int originalNetworkId, int transportStreamId, int serviceld) 
throws SiiiiegaiArgumentException 

Initiate monitoring of information in the PMT related to a service. When the information related to a 
service changes, an event will be delivered to the registered listener object. 

How the monitoring is performed is implementation dependent and especially does not necessarily 
need to be continuous. The event will be delivered as soon as the implementation notices the change 
which might have some delay relative to when the change was actually made in the stream due to 
resources for the monitoring being scheduled between the monitoring activities of different tables. 
Except as specified below, this specification does not set any minimum requirements for monitoring 
of the SI tables. This is to be done at a best effort basis by the implementation and is entirely 
implementation dependent. The only requirement is that when an implementation detects a change, 
e.g. because a resident Navigator or an MHP application has retrieved some SI information from the 
stream, then these listeners are notified of the change. When the referenced service is the currently 
selected service within a service context, the terminal shall monitor this PMT and report the changes 
to any registered listener(s). 

The monitoring stops silently and permanently when the network interface with which this 
SIDatabase object is associated starts tuning to another transport stream. 

Parameters: 

listener - listener object that will receive events when a change in the information is detected. 

originalNetworkId - original network identifier of the service 

transportStreamId - transport stream identifier of the service 

serviceld - service identifier specifying the service whose information will be monitored 

Throws: 

SiiiiegaiArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 



addServiceMonitoringListener(SIMonitoringListener, int, int) 

public void addServiceMonitoringListener (org . dvb . si . SIMonitoringListener listener, 
int originalNetworkId, int transportStreamId) 
throws SiiiiegaiArgumentException 

Initiate monitoring of information in the SDT related to services. When the information related to 
services changes, an event will be delivered to the registered listener object. 

The scope of the monitoring is determined by the original network identifier and transport stream 
identifier. The listener will be notified about the change of the information in any service within that 
scope. 

How the monitoring is performed is implementation dependent and especially does not necessarily 
need to be continuous. The event will be delivered as soon as the implementation notices the change 
which might have some delay relative to when the change was actually made in the stream due to 
resources for the monitoring being scheduled between the monitoring activities of different tables. 
This specification does not set any minimum requirements for monitoring of the SI tables. This is to 
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be done at a best effort basis by the implementation and is entirely implementation dependent. The 
only requirement is that when an implementation detects a change, e.g. because a resident 
Navigator or an MHP application has retrieved some SI information from the stream, then these 
listeners are notified of the change. 

The monitoring stops silently and permanently when the network interface with which this 
SIDatabase object is associated starts tuning to another transport stream. 

Parameters: 

listener - listener object that will receive events when a change in the information is detected. 

originalNetworkid - original network identifier specifying the scope of the monitoring. 
transportstreamid - transport stream identifier specifying the scope of the monitoring. 

Throws: 

siiiiegaiArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 

getSIDatabaseO 

public static org . dvb . si . SIDatabase[ ] getSIDatabaseO 

Return an array of SIDatabase objects (one object per network interface). In a system with one 
network interface, the length of this array will be one. The network interface of each SIDatabase is 
used as data source for all new data accessed by this SIDatabase or Sllnformation instances 
obtained from it. 

This is the first method to be called to access the DVB-SI API. The returned SIDatabase objects 
provide the access point to the DVB-SI information. 

Returns: 

An array of SIDatabase objects, one per network interface. 

removeBouquetMonitoringListener(SIMonitoringListener, int) 

public void removeBouquetMonitoringListener (org. dvb . si . SIMonitoringListener listener, 
int bouquetid) 
throws SiiiiegaiArgumentException 

Removes the registration of an event listener for bouquet information monitoring. If this method is 
called with a listener that is registered but not with the same identifiers of the SI objects as given in 
the parameters, the method shall fail silently and the listeners stays registered with those identifiers 
that it has been added. 

Parameters: 

listener - listener object that has previously been registered 

bouquetid - bouquet identifier of the bouquet whose information has been requested to be 
monitored 

Throws: 

SiiiiegaiArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 
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removeEventPresentFollowingMonitoringListener(SIMonitoringListener, int, int, int) 

public void removeEventPresentFollowingMonitoringListener (org . dvb . si . SIMonitoringListener 
listener, int originalNetworkId, int transportStreamId, int serviceld) 
throws SIIllegalArgumentException 

Removes the registration of an event listener for monitoring information related to present and 
following events If this method is called with a listener that is registered but not with the same 
identifiers of the SI objects as given in the parameters, the method shall fail silently and the listeners 
stays registered with those identifiers that it has been added. When the referenced service is carried 
in the currently tuned transport stream, the terminal shall monitor this EITp/f actual and report the 
changes to any registered listener(s). 

Parameters: 

listener - listener object that has previously been registered 

originalNetworkId - original network identifier specifying the scope of the monitoring. 
transportStreamId - transport stream identifier specifying the scope of the monitoring. 
serviceld - service identifier specifying the scope of the monitoring 

Throws: 

SIIllegalArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 



removeEventScheduleMonitoringListener(SIMonitoringListener, int, int, int) 

public void removeEventScheduleMonitoringListener (org . dvb . si . SIMonitoringListener listener, 
int originalNetworkId, int transportStreamId, int serviceld) 
throws SIIllegalArgumentException 

Removes the registration of an event listener for monitoring information related to scheduled events 
for all periods If this method is called with a listener that is registered but not with the same identifiers 
of the SI objects as given in the parameters, the method shall fail silently and the listeners stays 
registered with those identifiers that it has been added. 

Parameters: 

listener - listener object that has previously been registered 

originalNetworkId - original network identifier specifying the scope of the monitoring. 
transportStreamId - transport stream identifier specifying the scope of the monitoring. 
serviceld - service identifier specifying the scope of the monitoring 

Throws: 

SIIllegalArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 



removeNetworkMonitoringListener(SIMonitoringListener, int) 

public void removeNetworkMonitoringListener (org. dvb . si . SIMonitoringListener listener, 
int networkid) 
throws SIIllegalArgumentException 

Removes the registration of an event listener for network information monitoring. If this method is 
called with a listener that is registered but not with the same identifiers of the SI objects as given in 
the parameter, the method shall fail silently and the listeners stays registered with those identifiers 
that it has been added. 
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Parameters: 

listener - listener object that has previously been registered 

networkid - network identifier of the network which is no longer to be monitored by the listener 

Throws: 

SiillegalArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 



removePMTServiceMonitoringListener(SIMonitoringListener, int, int, int) 

public void removePMTServiceMonitoringListener (org . dvb . si . SIMonitoringListener listener, 
int originalNetworkId, int transportStreamId, int serviceld) 
throws SiillegalArgumentException 

Removes the registration of an event listener for monitoring information in the PMT related to a 
service. If this method is called with a listener that is registered but not with the same identifiers of 
the SI objects as given in the parameters, the method shall fail silently and the listeners stays 
registered with those identifiers that it has been added. 

Parameters: 

listener - listener object that has previously been registered 

originalNetworkId - original network identifier of the service 

transportStreamId - transport stream identifier of the service 

serviceld - service identifier specifying the service whose information has been requested to 
be monitored 

Throws: 

SiillegalArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 



removeServiceMonitoringListener(SIMonitoringListener, int, int) 

public void removeServiceMonitoringListener (org. dvb . si . SIMonitoringListener listener, 
int originalNetworkId, int transportStreamId) 
throws SiillegalArgumentException 

Removes the registration of an event listener for monitoring information related to services. If this 
method is called with a listener that is registered but not with the same identifiers of the SI objects as 
given in the parameters, the method shall fail silently and the listeners stays registered with those 
identifiers that it has been added. 

Parameters: 

listener - listener object that has previously been registered 

originalNetworkId - original network identifier specifying the scope of the monitoring. 
transportStreamId - transport stream identifier specifying the scope of the monitoring. 

Throws: 

SiillegalArgumentException - thrown if the identifiers are invalid (e.g. out of range) 

See Also: 

SIMonitoringListener, SIMonitoringEvent 
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retrieveActualSINetwork(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveActualSINetwork (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SI Illegal Argument Except ion 

Retrieve information associated wWh tine actual networl<. Tine actual network is the network carrying 
the transport stream currently selected by the network interface connected to this SIDatabase. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SINetwork interface. If no matching object was found, the appropriate one 
of the following events is sent: SIObjectNotlnCacheEvent or SITableNotFoundEvent 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SINetwork, DescriptorTag 



retrieveActualSIServices(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveActualSIServices (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SiiiiegaiArgumentException 

Retrieve information associated with the actual services. The actual services are the services in the 
transport stream currently selected by the network interface connected to this SIDatabase. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the SIService interface. If no matching object was found, the 
appropriate one of the following events is sent: siObjectNotinCacheEvent, 

SIObjectNotlnTableEvent or SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 
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appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 

retrieveActualSITransportStream(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveActualSITransportStream (short retrieveMode, 
j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SiillegalArgumentException 

Retrieve information associated with the actual transport stream. The actual transport stream is the 
transport stream currently selected by the network interface connected to this SIDatabase. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SITransportStreamNIT interface. If no matching object was found, the 
appropriate one of the following events is sent: SIObjectNotlnCacheEvent SIObjectNotlnTableEvent 
or SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SITransportStream, DescriptorTag 
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retrievePMTElementaryStreams(short, Object, SIRetrievalListener, DvbLocator, short[]) 

public org . dvb . si . SIRequest retrievePMTElementaryStreams (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
org . davic . net . dvb . DvbLocator dvbLocator, short [] someDescriptorTags) 
throws SI Illegal Argument Except ion 

Retrieve PMT elementary stream information associated witin components of a service. Tiie required 
component(s) can be specified by its DVB locator. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the PMTEIementaryStream interface. If no matching object was 
found, the appropriate one of the following events is sent: objectNotinCacheEvent, 
ObjectNotlnTableEvent or TableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

dvbLocator - DVB Locator identifying the component(s) of a service. The locator may be more 
specific than identifying one or more service components, but this method will only use the parts 
starting from the beginning up to the component tags. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid or if the locator is 
invalid and does not identify one or more service components 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 



retrievePMTElementaryStreams(short, Object, SIRetrievalListener, int, int, short[]) 

public org . dvb . si . SIRequest retrievePMTElementaryStreams (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
int serviceld, int componentTag, short [] someDescriptorTags) 
throws SiillegalArgumentException 

Retrieve PMT elementary stream information associated with components of a service from the 
actual transport stream of this SIDatabase object. The elementary streams can be specified by their 
identification. When -1 is specified for componentTag then elementary streams shall be retrieved 
regardless of their component tag. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the PMTEIementaryStream interface. If no matching object was 
found, the appropriate one of the following events is sent: siObjectNotinCacheEvent, 

SIObjectNotlnTableEvent or SITableNotFoundEvent. 
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Parameters: 

retrieveMode - Mode of retrieval indicating winetlner the data sinould be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

serviceid - Identification of the elementary streams to be retrieved: service identifier 

componentTag - Identification of the elementary streams to be retrieved: component tag (-1 
means return elementary streams regardless of their component tag) 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid or the numeric 
identifiers are out of range 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 



retrievePMTService(short, Object, SIRetrievalListener, DvbLocator, short[]) 

public org . dvb . si . SIRequest retrievePMTService (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
org . davic . net . dvb . DvbLocator dvbLocator, short [] someDescriptorTags) 
throws SiiiiegaiArgumentException 

Retrieve PMT information associated with a service. The required service can be specified by its 
DVB locator. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the PMTService interface. If no matching object was found, the appropriate 
one of the following events is sent: SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

dvbLocator - DVB Locator identifying the service. The locator may be more specific than 
identifying a service, but this method will only use the parts starting from the beginning up to the 
service id. 
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someDescriptorTags - A list of hints for descriptors (identified by tineir tags) tine application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid or the locator is invalid 
and does not identify a service 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 



retrievePMTServices(short, Object, SIRetrievalListener, int, short[]) 

public org . dvb . si . SIRequest retrievePMTServices (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
int serviceld, short [] someDescriptorTags) 
throws SiiiiegaiArgumentException 

Retrieve PMT information associated with services from the actual transport stream of this 
SIDatabase object. The required services can be specified by their identification. When -1 is 
specified as serviceld then services shall be retrieved regardless of their service id. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the PMTService interface. If no matching object was found, the 
appropriate one of the following events is sent: siObjectNotinCacheEvent, 

SIObjectNotlnTableEvent or SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

serviceld - Identification of the services to be retrieved: service identifier (-1 means return 
services regardless of their service id) 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SiiiiegaiArgumentException - thrown if the retrieveMode is invalid or the numeric 
identifiers are out of range 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 
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retrieveSIBouquets(short, Object, SIRetrievalListener, int, short[]) 

public org . dvb . si . SIRequest retrieveSIBouquets (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
int bouquetid, short [] someDescriptorTags) 
throws SI IllegalArgument Except ion 

Retrieve information associated witii bouquets. A bouquet can be specified by its identification. 
Winen bouquetid is set to -1, all bouquets signalled in the BAT of the currently received transport 
stream on that network interface are retrieved. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the SIBouquet interface. If no matching object was found, the 
appropriate one of the following events is sent: siObjectNotinCacheEvent, 

SIObjectNotlnTableEvent or SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

bouquetid - Identifier of the bouquet to be retrieved or -1 for all bouquets signalled on the 
currently received transport stream. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid or the numeric 
identifiers are out of range 

See Also: 

SIRequest, SIRetrievalListener, SIBouquet, DescriptorTag 



retrieveSINetworks(short, Object, SIRetrievalListener, int, short[]) 

public org . dvb . si . SIRequest retrieveSINetworks (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
int networkid, short [] someDescriptorTags) 
throws SiillegalArgumentException 

Retrieve information associated with networks. A network can be specified by its identification. When 
networkid is set to -1, all networks signalled in NIT Actual and Other of the currently received 
TransportStream on that network interface shall be retrieved. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the SINetwork interface. If no matching object was found, the 
appropriate one of the following events is sent: SiObjectNotinCacheEvent, 

SITableNotFoundEvent. 
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Parameters: 

retrieveMode - Mode of retrieval indicating winetlner the data sinould be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

networkid - Identification of the network to be retrieved or -1 for all networks currently 
signalled. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid or the numeric 
identifiers are out of range 

See Also: 

SIRequest, SIRetrievalListener, SINetwork, DescriptorTag 



retrieveSIService(short, Object, SIRetrievalListener, DvbLocator, short[]) 

public org. dvb . si . SIRequest retrieveSIService (short retrieveMode, Java . lang. Object appData, 
org . dvb . si . SIRetrievalListener listener, 

org . davic . net . dvb . DvbLocator dvbLocator, short [] someDescriptorTags) 
throws SiillegalArgumentException 

Retrieve information associated with a service. The required service can be specified by its DVB 
locator. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SIService interface. If no matching object was found, the appropriate one 
of the following events is sent:SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent" 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

dvbLocator - DVB locator identifying the service. The locator may be more specific than 
identifying a service, but this method will only use the parts starting from the beginning up to the 
service id. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
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all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid or the locator is invalid 
and does not identify a service 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 



retrieveSIServices(short, Object, SIRetrievalListener, int, int, int, short[]) 

public org . dvb . si . SIRequest retrieveSIServices (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
int originalNetworkId, int transportStreamId, int serviceld, 
short [] someDescriptorTags) 
throws SiiiiegaiArgumentException 

Retrieve information associated with services. The required services can be specified by their 
identification. When -1 is specified for transportStreamId then services shall be retrieved 
regardless of their transport stream id. When -1 is specified for serviceld then services shall be 
retrieved regardless of their service id. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the SIService interface. If no matching object was found, the 
appropriate one of the following events is sent: siObjectNotinCacheEvent, 

SIObjectNotlnTableEvent or SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

originalNetworkId - Identification of the services to be retrieved: original network identifier 

transportStreamId - Identification of the services to be retrieved: transport stream identifier 
(-1 means return services regardless of their transport stream id) 

serviceld - Identification of the services to be retrieved: service identifier (-1 means return 
services regardless of their service id) 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SiiiiegaiArgumentException - thrown if the retrieveMode is invalid or the numeric 
identifiers are out of range 
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See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 



retrieveSITimeFromTDT(short, Object, SIRetrievalListener) 

public org . dvb . si . SIRequest retrieveSITimeFromTDT (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener) 
throws SIIllegalArgumentException 

Retrieve information associated witin time from tine Time and Date Table (TDT) from Vne actual 
transport stream. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SITime interface. If no matching object was found, the appropriate one of 
the following events is sent:SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

Returns: 

An SIRequest object 

Throws: 

SIIllegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SITime 



retrieveSITimeFromTOT(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveSITimeFromTDT (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SIIllegalArgumentException 

Retrieve information associated with time from the Time Offset Table (TOT) from the actual transport 
stream. The time information will be accompanied with offset information 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SITime interface. If no matching object was found, the appropriate one of 
the following events is sent: SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 
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listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

SllllegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SITime 

retrieveSITransportStreamDescription(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveSITransportStreamDescription (short retrieveMode, 
j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SllllegalArgumentException 

Retrieve the SITransportStreamDescription object representing the information of the TSDT table in 
the actual transport stream of this SIDatabase object. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SITransportStreamDescription interface. If no matching object was 
found, the appropriate one of the following events is sent:SIObjectNotlnCacheEvent 
SIObjectNotlnTableEvent or SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SllllegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SITransportStreamDescription, 
Descriptor Tag 
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org.dvb.si 

SI Event 



Declaration 

public interface SIEvent extends Sllnformation 

All Superinterfaces: 

Sllnformation 

Description 

This interface represents a particular event within a service. 

Each object that implements the SIEvent interface is defined by the combination of the identifiers 
original_network_id, transport_stream_id, service_id, event_id. 

Where methods return values from a short_event_descriptor, the following algorithm shall be used where more 
than one such descriptor is present. If the language returned by 

javax . tv. service . SIManager. get Prefer redLanguage is one of those for which there is a 
short_event_descriptor then return the value from that descriptor. Otherwise return an implementation dependent 
selection between the values in the available short_event_descriptors. 

See Also: 

SIService 



Methods 



getContentNibblesO 

public byte [ ] getContentNibbles ( ) 

This method returns the content nibbles related to the event. This information is extracted from the 
content_descriptor. If this descriptor is not present an empty array is returned (array with length 0). 
The return value is an array, each array element describes one content nibble. In each nibble the 
level 1 content nibbles occupy the four most significant bits of the returned bytes, level 2 content 
nibbles the four least significant bits. 

Returns: 

The content nibbles related to the event; level 1 content nibbles occupy the four most significant 
bits of the returned bytes, level 2 content nibbles the four least significant bits. 



getDurationO 

public long getDurationO 

Get the duration of this event. 

Returns: 

The duration in seconds. 
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getDvbLocatorO 

public org . davic . net . dvb . DvbLocator getDvbLocatorO 

Gets a DvbLocator that identifies tinis event. 

Returns: 

Tiie DvbLocator of tinis event 



getEventlDO 

public int getEventlDO 

Get tine event identification. 

Returns: 

Tine event identification. 



getFreeCAModeO 

public boolean getFreeCAModeO 

Get tine free_CA_mode value for tiiis event, false indicates none of the component streams of this 
event are scrambled. 



Returns: 

The free CA mode value. 



getLevell ContentNibblesO 

public byte[] getLevellContentNibbles ( ) 

This method returns the level 1 content nibbles of this event. This information is extracted from the 
content_descriptor. If this descriptor is not present an empty array is returned (array with length 0). 
The return value is an array, each array element describes one content nibble. In each nibble the 
data occupies the four least significant bits of the returned bytes with the four most significant bits set 
too. 



Returns: 

All level 1 content nibbles related to the event. 



getNameO 

public j ava . lang. String getName ( ) 

This method returns the name of this event. The name is extracted from a short_event_descriptor. 
When this information is not available "" is returned. All control characters as defined in ETR 21 1 are 
ignored. For each character the DVB-SI 8 bit character code is mapped to the appropriate Unicode 
representation. 



Returns: 

The event name of this event. 



getOriginalNetworklDQ 

public int getOriginalNetworkID ( ) 

Get the original network identification identifier. 

Returns: 

The original network identification. 
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getRunningStatusQ 

public byte getRunningStatus ( ) 

Get the running status of this event. 

Returns: 

The running status (the possible values are defined in the SIRunningStatus interface). 

See Also: 

SIRunningStatus 

getServicelDQ 

public int getServicelD ( ) 

Get the service identification identifier. 

Returns: 

The service identification. 

getShortDescriptionO 

public Java . lang. String getShortDescription ( ) 

This method returns the description of this event. The description is extracted from a 
short_event_descriptor. When this information is not available, "" is returned. For each character the 
DVB-SI 8 bit character code is mapped to the appropriate Unicode representation 



Returns: 

The short description of this event. 



getShortEventNameO 

public Java . lang. String getShortEventNameO 

This method returns the short event name (ETR 211) of this event without emphasis marks. The 
name is extracted from a short_event_descriptor. If the descriptor is not present, "" is returned. If the 
string can be found but does not contain control codes for abbreviating it, the full string shall be 
returned. For each character the DVB-SI 8 bit character code is mapped to the appropriate Unicode 
representation. 

Returns: 

The short event name of this event. 



getStartTimeO 

public java.util . Date getStartTimeO 

Get the start time of this event in UTC time. 

Returns: 

The start time of this event. 

getTransportStreamlDO 

public int getTransportStreamlDO 

Get the transport stream identification identifier. 

Returns: 

The transport stream identification. 
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retrieveSIService(short, Object, SIRetrievalListener, short[]) 

public org.dvb . si . SIRequest retrieveSIService (short retrieveMode, Java . lang. Object appData, 
org . dvb . si . SIRetrievalListener listener, short[] someDescriptorTags) 
throws SIIllegalArgumentException 

This method retrieves the SIService object representing the service the event, represented by this 
SIEvent, is part of. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SIService interface. If no matching object was found, the appropriate one 
of the following events is sent: SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SIIllegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 
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org.dvb.si 

SI Exception 



Declaration 

public abstract class SIException extends j ava . lang. Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org.dvb . si . SIException 

All Implemented Interfaces: 

Java .io.Serializable 

Direct Known Subclasses: 

SIIllegalArgumentException, SIInvalidPeriodException 

Description 

This class is the root of the SI exceptions hierarchy. 



Constructors 



SIExceptionQ 

public SIException ( ) 

Default constructor for the exception 



SIException(String) 

public SIException (Java. lang. String reason) 

Constructor for the SI exception with a specified reason 

Parameters: 

reason - the reason why the exception was raised 
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org.dvb.si 

SllllegalArgumentException 



Declaration 

public class SllllegalArgumentException extends SIException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H org . dvb . si . SIException 

I 

+ — org . dvb . si . SllllegalArgumentException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This exception is thrown when one or more of the arguments passed to a method are invahd (e.g. numeric 
identifiers out of range, etc.) 



Constructors 

SIIllegalArgumentExceptionQ 

public SllllegalArgumentException () 

Default constructor for the exception 
SIIllegalArgumentException(String) 

public SllllegalArgumentException (j ava . lang. String reason) 

Constructor for the exception with a specified reason 

Parameters: 

reason - the reason why the exception was raised 
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org.dvb.si 

Sllnformation 



Declaration 

public interface Sllnformation 

All Known Subinter faces: 

PMTElementaryStream, PMTService, SIBouquet, SIEvent, SINetwork, SIService, 
SITime, SITransportStream, SITransportStreamBAT, 
SITransportStreamDescription, SITransportStreamNIT 

Description 

This interface groups the common features of SIBouquet, SINetwork, SITransportStream, SIService, PMTService, 
SIEvent, SITime and PMTElementaryStream. 

Each Sllnformation instance represents a sub-table (part). Any method accessing descriptors will retrieve 
descriptors from the same sub-table version as the Sllnformation instance. When this version is no longer available, 
an SITableUpdatedEvent is returned. 

See Also: 

SIBouquet, SINetwork, SITransportStream, SIService, PMTService, SIEvent, SITime, 
PMTElementaryStream 



Fields 



FROM_CACHE_ONLY 

public static final short FROM_CACHE_ONLY 

Constant for retrieve mode parameter of the retrieve metlnods. Winen FROIV!_CACHE_ONLY mode is 
specified, tine data will be retrieved only if it is in the cache. Otherwise, SINotlnCacheEvent will be 
delivered to the listener. No stream access is done in this case. 

FROM_CACHE_OR_STREAM 

public static final short FROM_CACHE_OR_STREAM 

Constant for retrieve mode parameter of the retrieve methods. When FROM_CACHE_OR_STREAM 
mode is specified, the data will be retrieved from cache if it is present in the cache, otherwise it will 
be retrieved from the stream. 

FROM_STREAM_ONLY 

public static final short FROM_STREAM_ONLY 

Constant for retrieve mode parameter of the retrieve methods. When FROM_STREAM_ONLY mode 
is specified, the data will be retrieved directly from the stream and no cache access is tried first. This 
mode is meaningful only if the application knows that the information is not in the cache or that the 
information in the cache is no longer valid, but the implementation of the SI database may not be 
aware of the invalidity of the cached data. If the application has got the notification of the existence of 
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an updated version through the listener mechanism in this API, the implementation of the SI 
database is aware of the version change and the application should specify the 
FROM_CACHE_OR_STREAM mode to be able to retrieve the data faster if the updated version has 
already been loaded to the cache by the SI database implementation. 



Methods 



fromActualQ 

public boolean f romActual ( ) 

Return true when the information contained in the object that implements this interface was filtered 
from an 'actual' table or from a table with no 'actual/other' distinction. 

Returns: 

true if the information comes from an 'actual' table or from a table with no 'actual/other' 
distiction, otherwise returns false 



getDataSourceO 

public org.davic.mpeg.TransportStream getDataSourceO 

Return the org.davic.mpeg.TransportStream object the information contained in the object that 
implements that interface was filtered from. 

Returns: 

The org.davic.mpeg.TransportStream object the information was filtered from. 

See Also: 

org . davic .mpeg . TransportStream 

getDescriptorTagsO 

public short [] getDescriptorTagsO 

Get the tags of all descriptors that are part of this version of this object. The tags are returned in the 
same order as the descriptors are broadcast. This method returns also the tags of descriptors that 
were not hinted at and that are not necessarily present in the cache. If there are no descriptors 
associated with this Sllnformation object, this method returns an empty array whose length is 0. 

Returns: 

The tags of the descriptors actually broadcast for the object (identified by their tags). 

See Also: 

Descriptor Tag 

getSIDatabaseO 

public org.dvb. si . SIDatabase getSIDatabaseO 

Return the root of the hierarchy the object that implements this interface belongs to. 

Returns: 

The root of the hierarchy. 
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getUpdateTimeO 

public java.util . Date getUpdateTimeO 

Return the time when the information contained in the object that implements this interface was last 



updated. 

Returns: 

The date of the last update. 



retrieveDescriptors(short, Object, SIRetrievalListener) 

public org . dvb . si . SIRequest retrieveDescriptors (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener) 
throws SI Illegal Argument Except ion 

This method retrieves all descriptors in the order the descriptors are broadcast. 

This method is asynchronous and the completion of the method will be signalled by an 
SiSuccessfulRetrieveEvent being sent to listener. Any retrieved descriptors are found in the 
Sllterator returned by the getResult method of that event. If descriptors are found then this iterator 
will contain Descriptor objects. If there are no matching descriptors, this iterator will contain no 
objects. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

Returns: 

An SIRequest object 

Throws: 

siillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, Descriptor, Sllterator 



retrieveDescriptors(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveDescriptors (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorlags) 
throws SiillegalArgumentException 

Retrieve a set of descriptors. This method retrieves all or a set of descriptors in the order the 
descriptors are broadcast. 

The tag values included in the someDescriptorTags parameter are used for filtering the 
descriptors that are returned. Only those descriptors whose tag value is included in the 
someDescriptorTags array are retrieved, unless the someDescriptorTags array contains -1 as 
its one and only item in which case all descriptors related to this object are retrieved. 

If the list of tags is a subset of the one hinted to the underlying implementation (in the request which 
created the object on which the method is called), this is likely to increase the efficiency of the 
(optional) caching mechanism 
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This method is asynchronous and the completion of the method will be signalled by an 
SiSuccessfulRetrieveEvent being sent to listener. Any retrieved descriptors are found in the 
Sllterator returned by the getResult method of that event. If descriptors are found then this iterator 
will contain Descriptor objects. If there are no matching descriptors, this iterator will contain no 
objects. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrlevalLlstener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - Descriptor tag values of descriptors that are used for filtering 
descriptors from the descriptors included in the SI table item corresponding to this SI Information 
object. If the array contains -1 as its one and only element, all descriptors related to this object 
are retrieved. 

Returns: 

An SI Request object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, Descriptor, Sllterator, DescriptorTag 
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org.dvb.si 

SI InvalidPeriod Exception 



Declaration 

public class SIInvalidPeriodException extends SIException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H org . dvb . si . SIException 

I 

+- -org. dvb. si . SIInvalidPeriodException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This exception is thrown when a specified period is invalid (for example, start time is after the end time) 



Constructors 

SIInvalidPeriodExceptionO 

public SIInvalidPeriodException ( ) 

Default constructor for the exception 
SIInvalidPeriodException(String) 

public SIInvalidPeriodException (Java . lang . String reason) 

Constructor for the exception with a specified reason 

Parameters: 

reason - the reason why the exception was raised 
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org.dvb.si 

SI Iterator 



Declaration 

public interface Sllterator extends Java. util .Enumeration 

All Superinterfaces: 

j ava . util . Enumeration 

Description 

Objects implementing Sllterator interface allow to browse through a set of SI objects. In order to maintain 
consistency within the set of SI objects, this browsing does NOT initiate an actual access to the stream. 



Methods 



numberOfRemainingObj ectsQ 

public int numberOfRemainingOb jects ( ) 

Get the number of remaining objects in the iterator. 

Returns: 

The number of remaining objects. 
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org.dvb.si 

SILackOfResourcesEvent 



Declaration 

public class SILackOfResourcesEvent extends SIRetrievalEvent 

Java . lang .Object 

+ — java.util . Even tObj act 
I 
+--org . dvb . si . SIRetrievalEvent 

+ — org. dvb . si . SILackOfResourcesEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent in response to a SI retrieval request when the resources needed for retrieving the data are not 
available, e.g. due to the necessary resources being all taken up by the calling application or other applications. 

See Also: 

SIRetrievalListener 



Constructors 

SILackOfResourcesEvent(Object, SIRequest) 

public SILackOfResourcesEvent (Java. lang. Object appData, org. dvb . si . SIRequest request) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 
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org.dvb.si 

SIMonitoringEvent 



Declaration 

public class SIMonitoringEvent extends Java . util .EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+--org.dvb. si . SIMonitoringEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Description 

Objects of this class are sent to listener objects of the using application to notify that a change in the monitored 
information has happened. 

See Also: 

SIMonitoringType, SIMonitoringListener 



Constructors 



SIMonitoringEvent(SIDatabase, byte, int, int, int, int, int, Date, Date) 

public SIMonitoringEvent (org. dvb . si . SIDatabase source, byte objectType, int networkid, 
int bouquetid, int originalNetworkId, int transportStreamId, int serviceld, 
j ava . util . Date startTime, Java . util . Date endTime) 

Constructor for the event object 

Parameters: 

source - the SIDatabase object which is the source of the event 

objectType - type of the SI Information object (constants in SIMonitoringType) 

networkid - networkId 

bouquetid - bouquetId 

originalNetworkId - originalNetworkId 

transportStreamId - transportStreamId 

serviceld - serviceld 

StartTime - Start time of event schedule period 

endTime - end time of event schedule period 
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Methods 



getBouquetlDQ 

public int getBouquetID () 

Returns the bouquetid of the bouquet. This method is only applicable if the Sllnformation type 



returned with the getSllnformationType method is BOUQUET. 

Returns: 

the bouquetid or -2 if not applicable for this event 



getEndTimeO 

public Java . util . Date getEndTimeO 

Returns the end time of the schedule period whose event information has changed. This method is 
only applicable if the Sllnformation type returned with the getSllnformationType method is 
SCHEDULED EVENT 



Returns: 

the end time or null if not applicable for this event 



getNetworklDQ 

public int getNetworkID ( ) 

Returns the networkid of the network. This method is only applicable if the Sllnformation type 



returned with the getSllnformationType method is NETWORK. 

Returns: 

the networkid or -2 if not applicable for this event 



getOriginalNetworklDO 

public int getOriginalNetworkID ( ) 

Returns the originalNetworkId of the Sllnformation objects This method is only applicable if the 
Sllnformation type returned with the getSllnformationType method is SERVICE, PMT_SERVICE, 
PRESENT FOLLOWING EVENT or SCHEDULED EVENT 



Returns: 

the originalNetworkId or -2 if not applicable for this event 



getServicelDQ 

public int getServicelD ( ) 

Returns the serviceld of the Sllnformation objects This method is only applicable if the Sllnformation 
type returned with the getSllnformationType method is PMT_SERVICE, 
PRESENT_FOLLOWING_EVENT or SCHEDULED_EVENT 

Returns: 

the serviceld or -2 if not applicable for this event 
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getSIInformationTypeO 

public byte getSIInformationTypeO 

Get the Sllnformation type of the information that has changed 

Returns: 

The Sllnformation type (the possible values are defined in the SIMonitoringType interface). 

See Also: 

SIMonitoringType 

getSourceO 

public Java. lang. Object getSourceO 

Gets the SIDatabase instance that is sending the event. 

Overrides: 

getSource in class EventObject 

Returns: 

the SIDatabase instance that is the source of this event. 

getStartTimeO 

public java.util . Date getStartTimeO 

Returns the start time of the schedule period whose event information has changed. This method is 
only applicable if the Sllnformation type returned with the getSllnformationType method is 
SCHEDULED EVENT 



Returns: 

the start time or null if not applicable for this event 



getTransportStreamlDO 

public int getTransportStreamID ( ) 

Returns the transportStreamId of the Sllnformation objects This method is only applicable if the 
Sllnformation type returned with the getSllnformationType method is SERVICE, PMT_SERVICE, 
PRESENT FOLLOWING EVENT or SCHEDULED EVENT 



Returns: 

the transportStreamId or -2 if not applicable for this event 
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org.dvb.si 

SIMonitoringListener 

Declaration 

public interface SIMonitoringListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

This interface shall be implemented by using application classes in order to listen to changes in monitored SI 
objects. 

See Also: 

SIMonitoringEvent 



Methods 

postMomtoringEvent(SIMonitoringEvent) 

public void postMonitoringEvent (org. dvb . si . SIMonitoringEvent anEvent) 

This method is called back by the SI API implementation to notify the listener about an event. 

Parameters: 

anEvent - The notified event. 

See Also: 

SIMonitoringEvent 
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org.dvb.si 

SIMonitoringType 



Declaration 

public interface SIMonitoringType 

Description 

This interface defines the constants corresponding to the SI information type values in SIMonitoringEvent. 

See Also: 

SIMonitoringListener, SIMonitoringEvent 



Fields 

BOUQUET 

public static final byte BOUQUET 

Constant for the type of Sllnformation object: Bouquet 
NETWORK 

public static final byte NETWORK 

Constant for the type of Sllnformation object: Network 
PMT_SERVICE 

public static final byte PMT_SERVICE 

Constant for the type of Sllnformation object: PMTService 
PRESENT_FOLLOWING_EVENT 

public static final byte PRESENT_FOLLOWING_EVENT 

Constant for the type of Sllnformation object: Present or following event 
SCHEDULED_EVENT 

public static final byte SCHEDULED_EVENT 

Constant for the type of Sllnformation object: Scheduled event 
SERVICE 

public static final byte SERVICE 

Constant for the type of Sllnformation object: Service 
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org.dvb.si 

SI Network 



Declaration 

public interface SINetwork extends Sllnformation 

All Superinterfaces: 

Sllnformation 

Description 

This interface (together with the SITransportStreamNIT interface) represents a sub-table of the Network 
Information Table (NIT) describing a particular network. 

Each object that implements the SINetwork interface is identified by the identifier network_id. 
See Also: 

SITransportStream, SITransportStreamNIT 



Methods 



getDescriptorTagsO 

public short [] getDescriptorTagsO 

This method defines extra semantics for the Sllnformation. getDescriptorTags method. If the NIT sub- 
table on which this SINetwork object is based consists of multiple sections, then this method returns 
the descriptor tags in the order they appear when concatenating the descriptor loops of the different 
sections. 

Overrides: 

getDescriptorTags in interface Sllnformation 

Returns: 

The tags of the descriptors actually broadcast for the object (identified by their tags). 

See Also: 

Sllnformation, Sllnformation . getDescriptorTags () 

getNameO 

public Java. lang. String getNameO 

This method returns the name of this network. If the language returned by 
javax . tv. service . SIManager.getPreferredLanguage is one of those in the 
multilingual_network_name_descriptor, return the name in that language, otherwise return an 
implementation dependent selection between the names in the 

multilingual_network_name_descriptor and the name in the network_name_descriptor. When this 
information is not available "" is returned. All control characters as defined in ETR 211 are ignored. 
For each character the DVB-SI 8 bit character code is mapped to the appropriate Unicode 
representation. 

Returns: 

The network name of this network. 
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getNetworklDQ 

public int getNetworkID ( ) 

Get the identification of tiiis networl<. 

Returns: 

The networl< identification identifier. 



getShortNetworkNameO 

public Java . lang. String getShortNetworkName ( ) 

This method returns the short name (ETR 211) of this networl< without emphasis marl<s. If the 
language returned by javax.tv. service. SIManager.getPreferredLanguage is one of 
those in the multilingual_network_name_descriptor, return the name in that language, otherwise 
return an implementation dependent selection between the names in the 
multilingual_network_name_descriptor and the name in the network_name_descriptor. If the 
descriptor is not present, "" is returned. If the string can be found but does not contain control codes 
for abbreviating it, the full string shall be returned. For each character the DVB-SI 8 bit character 
code is mapped to the appropriate Unicode representation. 

Returns: 

The short network name of this network. 



retrieveDescriptors(short, Object, SIRetrievalListener) 

public org . dvb . si . SIRequest retrieveDescriptors (short retrieveMode, 

j ava . lang. Object appData, org . dvb . si . SIRetrievalListener listener) 
throws SI Illegal Argument Except ion 

This method defines extra semantics for the Sllnformation. retrieveDescriptors method (first 
prototype). If the NIT sub-table on which this SINetwork object is based consists of multiple sections, 
then this method returns the requested descriptors in the order they appear when concatenating the 
descriptor loops of the different sections. 

Overrides: 

retrieveDescriptors in interface Sllnformation 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

Returns: 

An SIRequest object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid 

See Also: 

Sllnformation, Sllnformation . retrieveDescriptors (short, Object, 
SIRetrievalListener) 
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retrieveDescriptors(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveDescriptors (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SI Illegal Argument Except ion 

This method defines extra semantics for the Sllnformation. retrieveDescriptors method (second 
prototype). If the NIT sub-table on which this SINetwork object is based consists of multiple sections, 
then this method returns the requested descriptors in the order they appear when concatenating the 
descriptor loops of the different sections. 

Overrides: 

retrieveDescriptors in interface Sllnformation 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of tags for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the the behaviour is implementation dependent. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

siillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

Sllnformation, Sllnformation . retrieveDescriptors (short, Object, 
SIRetrievalListener, short[ ] ) 



retrieveSITransportStreams(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveSITransportStreams (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SiillegalArgumentException 

Retrieve information associated with transport streams carried via the network. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the SITransportStreamNIT interface. This method will retrieve 
SITransportStreams from the same sub-table version as this SINetwork instance. If this version of 
the sub-table is no longer available, an SITableUpdatedEvent is returned. 
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Parameters: 

retrieveMode - Mode of retrieval indicating winetlner the data sinould be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the behaviour is implementation dependent. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SITransportStreamNIT, DescriptorTag 



ETSI 



468 ETSITS 101 812V1.3.1 (2003-06) 



org.dvb.si 

SINotlnCacheEvent 



Declaration 

public class SINotlnCacheEvent extends SIRetrievalEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . si . SIRetrievalEvent 

+ — org. dvb . si . SINotlnCacheEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent in response to a SI retrieval request when the request was made with the FROM_CACHE_ONLY 
mode and the requested data is not present in the cache. 

See Also: 

SIRetrievalListener 



Constructors 



SINotInCacheEvent(Object, SIRequest) 

public SINotlnCacheEvent (Java. lang. Object appData, org . dvb . si . SIRequest request) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 
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org.dvb.si 

SIObjectNotlnTableEvent 

Declaration 

public class SIObjectNotlnTableEvent extends SIRetrievalEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . si . SIRetrievalEvent 

+ — org. dvb . si . SIObjectNotlnTableEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent in response to a SI retrieval request when the SI table where the information about the requested 
object should be located has been retrieved but the requested object is not present in it. The reason may be that the 
object corresponding to the requested identifiers does not exist. 

See Also: 

SIRetrievalListener 



Constructors 

SlObj ectNotInTableEvent(Obj ect, SIRequest) 

public SIObjectNotlnTableEvent (Java . lang .Object appData, org . dvb . si . SIRequest request) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 
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org.dvb.si 

SIRequest 



Declaration 

public class SIRequest 
Java . lang .Object 

+ — org . dvb . si . SIRequest 

Description 

Object instances of this class represent SI retrieval requests made by the application. The application may cancel 
the request using this object. 



Constructors 

SIRequestO 

protected SIRequestO 

This constructor is provided for tine use of implementations and specifications winicin extend tinis 
specification. Applications shall not define sub-classes of this class. Implementations are not 
required to behave correctly if any such application defined sub-classes are used. 



Methods 



cancelRequestQ 

public boolean cancelRequest ( ) 

Cancels the retrieval request. 

Returns: 

true if the request was cancelled and an SIRequestCancelledEvent will be delivered to the 
listener, false if the request has already completed (either successfully, with an error or due to a 
prior cancel method call) 

isAvailablelnCacheO 

public boolean isAvailablelnCacheO 

Returns whether the information will be returned from cache or from the stream 

Returns: 

true if the information is available in the cache and will be returned from there otherwise false 
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org.dvb.si 

SIRequestCancelledEvent 



Declaration 

public class SIRequestCancelledEvent extends SIRetrievalEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . si . SIRetrievalEvent 

+ — org. dvb . si . SIRequestCancelledEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent in response to a SI retrieval request when the request is cancelled with the 
SIRequest.cancelRequest method call. 

See Also: 

SIRequest, SIRetrievalListener 



Constructors 

SIRequestCancelledEvent(Obj ect, SIRequest) 

public SIRequestCancelledEvent (Java. lang. Object appData, org . dvb . si . SIRequest request) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 
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org.dvb.si 

SIRetrievalEvent 



Declaration 

public abstract class SIRetrievalEvent extends Java . util .EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+--org.dvb. si . SIRetrievalEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Direct Known Subclasses: 

SILackOfResourcesEvent, SINotlnCacheEvent, SIObjectNotlnTableEvent, 
SIRequestCancelledEvent, SISuccessf ulRetrieveEvent, SITableNotFoundEvent, 
SITableUpdatedEvent 

Description 

This class is the base class for events about completion of a SI retrieval request. Exactly one event will be returned 
in response to an SI retrieval request. 

See Also: 

SIRetrieval Listener 



Constructors 



SIRetrievalEvent(Obj ect, SIRequest) 

public SIRetrievalEvent (Java . lang. Object appData, org . dvb . si . SIRequest request) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 



Methods 



getAppDataO 

public Java. lang. Object getAppData ( ) 

Returns the application data that was passed to the retrieve method 

Returns: 

the application data 
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getSourceO 

public Java. lang. Object getSource ( ) 

Returns the SIRequest object that is the source of this event 

Overrides: 

getSource in class EventObject 

Returns: 

the SIRequest object 



ETSI 



474 ETSITS 101 812V1.3.1 (2003-06) 



org.dvb.si 

SIRetrievalListener 



Declaration 

public interface SIRetrievalListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

This interface shall be implemented by application classes in order to receive events about completion of SI 
requests. 

See Also: 

SIRetrievalEvent 



Methods 

postRetrievalEvent(SIRetrievalEvent) 

public void postRetrievalEvent (org . dvb . si . SIRetrievalEvent event) 

This method is called by the SI API implementation to notify the listener about completion of an SI 
request. 

Parameters: 

event - The event object. 

See Also: 

SIRetrievalEvent 
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org.dvb.si 

SIRunningStatus 



Declaration 

public interface SIRunningStatus 

Description 

This interface defines the constants corresponding to the running status values for services and events. 



Fields 

NOT_RUNNING 

public static final byte NOT_RUNNING 

Constant value for the running status as specified in EN 300 468 
PAUSING 

public static final byte PAUSING 

Constant value for the running status as specified in EN 300 468 
RUNNING 

public static final byte RUNNING 

Constant value for the running status as specified in EN 300 468 
STARTS_IN_A_FEW_SECONDS 

public static final byte STARTS_IN_A_FEW_SECONDS 

Constant value for the running status as specified in EN 300 468 
UNDEFINED 

public static final byte UNDEFINED 

Constant value for the running status as specified in EN 300 468 
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org.dvb.si 

SIService 



Declaration 

public interface SIService extends SI Information, TextualServiceldentif ierQuery 

All Superinterfaces: 

SI Information, TextualServiceldentif ierQuery 

Description 

This interface represents a particular service carried by a transport stream. Information that can be obtained 
through the methods of this interface is retrieved from the SDT table. 

Each object that implements the SIService interface is identified by the combination of the following identifiers: 
original_network_id, transport_stream_id, service_id. 



Methods 



getDvbLocatorQ 

public org . davic. net . dvb . DvbLocator getDvbLocator ( ) 

Gets a DvbLocator that identifies tinis service. 

Returns: 

Tiie DvbLocator of tin is service 



getEITPresentFollowingFlagO 

public boolean getEITPresentFollowingFlagO 

Get tine EIT_present_following_flag value, true indicates tiiis service inas present and/or following 
event information. 



Returns: 

The EIT_present_following_flag value. 



getEITScheduleFlagO 

public boolean getEITScheduleFlagO 

Get the EIT_schedule_flag value, true indicates this services has scheduled event information. 



Returns: 

The EIT_schedule_flag value. 



getFreeCAModeO 

public boolean getFreeCAModeO 

Retrieve the free_CA_mode value of this service, false indicates none of the components of this 
service are scrambled. 

Returns: 
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The free_CA_mocle value of this service. 



getNameO 

public Java. lang. String getNameO 

This method returns the name of the service represented by this service. If the language returned by 
javax . tv. service . SIManager.getPreferredLanguage is one of those in the 
multilinguaLservice_name_descriptor, return the name in that language, otherwise return an 
implementation dependent selection between the names in the 

multilingual_service_name_descriptor and the name in the service_descriptor. If this descriptor is 
not present "" is returned. All control characters as defined in ETR 211 are ignored. For each 
character the DVB-SI 8 bit character code is mapped to the appropriate Unicode representation. 

Returns: 

The name of this service. 



getOriginalNetworklDQ 

public int getOriginalNetworkID ( ) 

Get the original network identification. 

Returns: 

The original network identification identifier. 



getProviderNameO 

public Java. lang. String getProviderNameO 

This method returns the service provider name of this service If the language returned by 
javax . tv. service . SIManager.getPreferredLanguage is one of those in the 
multilinguaLservice_name_descriptor, return the name in that language, otherwise return an 
implementation dependent selection between the names in the 

multilingual_service_name_descriptor and the name in the service_descriptor. If this descriptor is 
not present "" is returned. All control characters as defined in ETR 211 are ignored. For each 
character the DVB-SI 8 bit character code is mapped to the appropriate Unicode representation. 

Returns: 

The service provider name of this service. 



getRunningStatusO 

public byte getRunningStatusO 

Retrieve the running status of this service. 

Returns: 

The running status (the possible values are defined in the SIRunningStatus interface) 

See Also: 

SIRunningStatus 

getServicelDQ 

public int getServicelD ( ) 

Get the service identification. 
Returns: 
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The service identification identifier. 



getShortProviderNameQ 

public Java . lang. String getShortProviderName ( ) 

Tinis metinod returns tine sinort name (ETR 211) of tiie service provider of Ms service witiiout 
empiiasis marl<s. If tine language returned by 

javax . tv. service . SIManager.getPreferredLanguage is one of those in the 
multilinguaLservice_name_descriptor, return the name in that language, otherwise return an 
implementation dependent selection between the names in the 

multilinguaLservice_name_descriptor and the name in the service_descriptor. When this 
information is not available "" is returned. For each character the DVB-SI 8 bit character code is 
mapped to the appropriate Unicode representation. 

Returns: 

The short service provider name of this service. 



getShortServiceNameO 

public Java . lang. String getShortServiceNameO 

This method returns the short name (ETR 211) of this service without emphasis marks. If the 
language returned by javax.tv. service. SIManager.getPreferredLanguage is one of 
those in the multilinguaLservice_name_descriptor, return the name in that language, otherwise 
return an implementation dependent selection between the names in the 
multilingual_service_name_descriptor and the name in the service_descriptor. If the descriptor is not 
present, "" is returned. If the string can be found but does not contain control codes for abbreviating 
it, the full string shall be returned. For each character the DVB-SI 8 bit character code is mapped to 
the appropriate Unicode representation. 

Returns: 

The short name of this service. 



getSIServiceTypeO 

public short getSIServiceTypeO 

Get the service type. The service type is extracted from the service_descriptor. 

Returns: 

The service type. (Some of the possible values are defined in the SIServiceType interface.) 

See Also: 

SIServiceType 

getTransportStreamlDQ 

public int getTransportStreamID () 

Get the transport stream identification. 

Returns: 

The transport stream identification identifier. 
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retrieveFollowingSIEvent(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveFollowingSIEvent (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SI Illegal Argument Except ion 

Retrieve information associated witin tine following event from the EIT-present/following. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SIEvent interface. If no matching object was found, the appropriate one of 
the following events is sent: SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SIEvent, DescriptorTag 



retrievePMTService(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrievePMTService (short retrieveMode, 

j ava . lang. Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SiiiiegaiArgumentException 

Retrieve the PMTService information associated with this service. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the PMTService interface. If no matching object was found, the appropriate 
one of the following events is sent: SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 
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listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SI Request object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, PMTService, DescriptorTag 



retrievePresentSIEvent(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrievePresentSIEvent (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SiillegalArgumentException 

Retrieve information associated with the present event from the EIT-present/following. 

The SI Iterator that is returned with the event when the request completes successfully will contain an 
object that implements the SIEvent interface. If no matching object was found, the appropriate one of 
the following events is sent:SIObjectNotlnCacheEvent SIObjectNotlnTableEvent or 
SITableNotFoundEvent. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

SiillegalArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SIEvent, DescriptorTag 



ETSI 



481 ETSITS 101 812V1.3.1 (2003-06) 



retrieveScheduledSIEvents(short, Object, SIRetrievalListener, short[], Date, Date) 

public org . dvb . si . SIRequest retrieveScheduledSIEvents (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 

short[] someDescriptorTags, j ava . util . Date startTime, Java . util . Date endTime) 

throws SIIllegalArgumentException, SIInvalidPeriodException 

Retrieve information associated witii tine sclneduled events witiiin tine service for a requested period 
from tiie EIT-scinedule. Tine events are presented in the order tiney are present in tine EIT-scinedule. A 
scineduled event is retrieved by tinis metinod if tine time interval from tine start time of tine event 
(inclusive) (as returned by SIEvent.getStartTime) to the end time of the event (exclusive) (as defined 
by the sum of SIEvent.getStartTime and SIEvent.getDuration) intersects the time interval from 
StartTime (inclusive) to endTime (exclusive) specified by the input parameters to this method. 

The Sllterator that is returned with the event when the request completes successfully will contain 
one or more objects that implement the SI Event interface. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

StartTime -The beginning of the required period in UTC time. 

endTime - The end of the required period in UTC time. 

Returns: 

An SIRequest object 

Throws: 

SIIllegalArgumentException - thrown if the retrieveMode is invalid 

SIInvalidPeriodException - When no valid period is indicated. 

See Also: 

SIRequest, SIRetrievalListener, SIEvent, DescriptorTag 
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org.dvb.si 

SIServiceType 



Declaration 

public interface SIServiceType 

Description 

This interface defines constants corresponding to the different service types. 

See Also: 

SI Service .get SIServiceType () 



Fields 

D_D2_MAC 

public static final short D_D2_MAC 

Constant value for the service type as specified in EN 300 468 
DATA_BROADCAST 

public static final short DATA_BROADCAST 

Constant value for the service type as specified in EN 300 468 
DIGITAL_RADIO_SOUND 

public static final short DIGITAL_RADIO_SOUND 

Constant value for the service type as specified in EN 300 468 
DIGITAL_TELEVISION 

public static final short DIGITAL_TELEVISION 

Constant value for the service type as specified in EN 300 468 
FM_RADIO 

public static final short FM_RADIO 

Constant value for the service type as specified in EN 300 468 
MHP_APPLICATION 

public static final short MHP_APPLICATION 

Constant value for the service type as specified in EN 300 468 
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MOSAIC 

public static final short MOSAIC 

Constant value for the service type as specified in EN 300 468 



NTSC 

public static final short NTSC 

Constant value for the service type as specified in EN 300 468 



NVOD_REFERENCE 

public static final short NVOD_REFERENCE 

Constant value for the service type as specified in EN 300 468 



NVOD_TIME_SHIFTED 

public static final short NVOD_TIME_SHIFTED 

Constant value for the service type as specified in EN 300 468 



PAL 

public static final short PAL 

Constant value for the service type as specified in EN 300 468 



SECAM 

public static final short SECAM 

Constant value for the service type as specified in EN 300 468 



TELETEXT 

public static final short TELETEXT 

Constant value for the service type as specified in EN 300 468 



UNKNOWN 

public static final short UNKNOWN 

Constant value for the service type as specified in EN 300 468 
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org.dvb.si 

SISuccessfulRetrieveEvent 



Declaration 

public class SISuccessfulRetrieveEvent extends SIRetrievalEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . si . SIRetrievalEvent 

+ — org. dvb . si . SISuccessfulRetrieveEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent in response to a SI retrieval request when the retrieve request was successfully completed. The 
result of the request can be obtained from the getResult method. 

See Also: 

SIRetrievalListener 



Constructors 



SISuccessfulRetrieveEvent(Object, SIRequest, Sllterator) 

public SISuccessfulRetrieveEvent (Java. lang. Object appData, org . dvb . si . SIRequest request, 
org . dvb . si . Sllterator result) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 
result - an Sllterator containing the retrieved objects 

Methods 



getResultO 

public org. dvb. si . Sllterator getResultO 

Returns the requested data in an Sllterator object. 

Returns: 

An Sllterator containing the requested objects 

See Also: 

SIObjectNotlnTableEvent 
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org.dvb.si 

SITableNotFoundEvent 



Declaration 

public class SITableNotFoundEvent extends SIRetrievalEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . si . SIRetrievalEvent 

+ — org . dvb . si . SITableNotFoundEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent in response to a SI retrieval request when the SI table that should contain the requested 
information could not be retrieved. The reason may be that the requested table is not broadcast in the transport 
stream currently associated with the SI database. 

See Also: 

SIRetrievalListener 



Constructors 

SITableNotFoundEvent(Obj ect, SIRequest) 

public SITableNotFoundEvent (Java . lang. Object appData, org . dvb . si . SIRequest request) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 
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org.dvb.si 

SITableUpdatedEvent 

Declaration 

public class SITableUpdatedEvent extends SIRetrievalEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . si . SIRetrievalEvent 

+ — org . dvb . si . SITableUpdatedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent in response to a SI descriptor retrieval request when the table carrying the information about the 
object has been updated and the set of descriptors consistent with the old object can not be retrieved. The 
application should in this case first update the Sllnformation object and then request the descriptors again. 

See Also: 

SIRetrievalListener 



Constructors 

SITableUpdatedE vent(Obj ect, SIRequest) 

public SITableUpdatedEvent (Java. lang. Object appData, org. dvb . si . SIRequest request) 

The constructor for the event 

Parameters: 

appData - the application data passed in the request method call 

request - the SIRequest instance which is the source of the event 
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org.dvb.si 

SITime 



Declaration 

public interface SITime extends SI Information 

All Superinterfaces: 

SI Information 

Description 

This interface represents the Time and Date Table (TDT) and the (optional) Time Offset Table (TOT). When it 
represents a TDT table, the retrieveDescriptors and getDescriptorTags methods behave as 
documented in the case when there are no descriptors, because the TDT does not contain any descriptors. 

See Also: 

SIDatabase 



Methods 



getUTCTimeO 

public java.util . Date getUTCTimeO 

Get the UTC time as coded in tine TDT or TOT table. 

Returns: 

The UTC as coded in tine TDT or TOT table. 
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org.dvb.si 

SITransportStream 

Declaration 

public interface SITransportStream extends Sllnformation 

All Superinterfaces: 

Sllnformation 

All Known Subinterfaces: 

SITransportStreamBAT, SITransportStreamNIT 

Description 

This interface is the base interface for representing information about transport streams. 

Transport stream retrieval methods in the SIDatabase class and the SINetwork interface use the NIT table and will 
return objects that implement the SITransportStreamNIT interface. 

Transport stream retrieval methods in the SIBouquet interface use the BAT table and will return objects that 
implement the SITransportStreamBAT interface. 



Methods 



getDvbLocatorO 

public org.davic. net . dvb. DvbLocator getDvbLocatorO 

Gets a DvbLocator that identifies tiiis transport stream. 

Returns: 

The DvbLocator of tinis transport stream. 

getOriginalNetworklDO 

public int getOriginalNetworkID ( ) 

Get tine original networl< identification. 

Returns: 

Tine original network identification identifier. 

getTransportStreamlDQ 

public int getTransportStreamID ( ) 

Get the transport stream identification. 

Returns: 

The transport stream identification identifier. 
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retrieveSIServices(short, Object, SIRetrievalListener, short[]) 

public org . dvb . si . SIRequest retrieveSIServices (short retrieveMode, 

j ava . lang .Object appData, org. dvb . si . SIRetrievalListener listener, 
short [] someDescriptorTags) 
throws SI Illegal Argument Except ion 

Retrieve information associated witin services carried via tine transport stream. Tinis metinod worl<s in 
tine same way for objects tiiat implement tine SITransportStreamNIT and SITransportStreamBAT 
interfaces. 

Tine Sllterator tinat is returned witin tine event winen tine request completes successfully will contain 
objects that implement the SIService interface. 

Parameters: 

retrieveMode - Mode of retrieval indicating whether the data should be retrieved only from the 
cache (FROM_CACHE_ONLY), from the cache if available and if not from the stream 
(FROM_CACHE_OR_STREAM), or always from the stream (FROM_STREAM_ONLY). 

appData - An object supplied by the application. This object will be delivered to the listener 
when the request completes. The application can use this objects for internal communication 
purposes. If the application does not need any application data, the parameter can be null. 

listener - SIRetrievalListener that will receive the event informing about the completion of the 
request. 

someDescriptorTags - A list of hints for descriptors (identified by their tags) the application is 
interested in. If the array contains -1 as its one and only element, the application is interested in 
all descriptors. If someDescriptorTags is null, the application is not interested in descriptors. All 
values that are out of the valid range for descriptor tags (i.e. 0...255) are ignored, except for the 
special meaning of -1 as the only element in the array. 

Returns: 

An SIRequest object 

Throws: 

siiiiegaiArgumentException - thrown if the retrieveMode is invalid 

See Also: 

SIRequest, SIRetrievalListener, SIService, DescriptorTag 
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org.dvb.si 

SITransportStreamBAT 

Declaration 

public interface SITransportStreamBAT extends SITransportStream 

All Superinterfaces: 

Sllnf ormation, SITransportStream 

Description 

This interface represents information about transport streams that has been retrieved from a BAT table. All 
descriptor accessing methods return descriptors retrieved from a BAT table. Methods in SIBouquet for retrieving 
transport streams return objects that implement this interface. 



Methods 

getBouquetlDO 

public int getBouquetlDO 

Get the identification of tine bouquet tiiis transport stream is part of. 

Returns: 

Tine bouquet identification identifier. 
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org.dvb.si 

SITransportStreamDescription 



Declaration 

public interface SITransportStreamDescription extends Sllnformation 

All Superinterfaces: 

Sllnformation 

Description 

This interface represents the Transport Stream Description Table (TSDT). 

It defines no methods of its own other than those inherited from Sllnformation. 

See Also: 

SIDatabase, SITransportStream 
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org.dvb.si 

SITransportStreamNIT 

Declaration 

public interface SITransportStreamNIT extends SITransportStream 

All Superinterfaces: 

Sllnf ormation, SITransportStream 

Description 

This interface represents information about transport streams that has been retrieved from a NIT table. All 
descriptor accessing methods return descriptors retrieved from a NIT table. Methods in SIDatabase and SINetwork 
for retrieving transport streams return objects that implement this interface. 



Methods 

getNetworklDO 

public int getNetworklDO 

Get the identification of tine networl< tinis transport stream is part of 

Returns: 

Tiie networl< identification identifier. 
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org.dvb.si 

SlUtil 



Declaration 

public class SlUtil 
Java . lang .Object 

+ — org . dvb . si . SlUtil 

Description 

This class contains SI related utility functions. 



Methods 



convertSIStringToJavaString(byte[l, int, int, boolean) 

public static j ava . lang. String convertSIStringToJavaString (byte [ ] dvbSIText, int offset, 
int length, boolean emphasizedPartOnly ) 
throws SI Illegal Argument Except ion 

This method converts a text string that is coded according to annex A of the DVB-SI specification 
(EN 300 468) to a Java String object. 

The text that must be converted is contained in 'dvbSIText' from index 'offset' to index 'offset+length- 
1' (inclusive). 

If the text that must be converted is not validly coded according to annex A of the DVB-SI 
specification, then the result is undefined. 

Parameters: 

dvbSIText - The byte array that contains the string that must be converted. 

offset - The offset indicates the start of the DVB-SI text in dvbSIText. 

length - Length of the DVB-SI text in bytes. 

emphasizedPartOnly - If emphasizedPartOnly is true, then only the text that is marked as 
emphasized (using the character emphasis on [0x86] and character emphasis off [0x87] control 
codes) will be returned. Otherwise, the character emphasis codes will be ignored, and all of the 
converted text will be returned. 

Returns: 

The converted text. 

Throws: 

siiiiegaiArgumentException - thrown if offset and/or offset+length-1 is not a valid index in 
dvbSIText. 
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org.dvb.si 

TextualServiceldentifierQuery 

Declaration 

public interface TextualServiceldentifierQuery 

All Known Subinter faces: 

SIService 

Description 

An interface that can be implemented by objects representing DVB services. Allows applications to obtain the 
textual service identifiers related to a service. 

Since: 

MHP1.0.1 



Methods 



getTextualServiceldentiflersO 

public Java . lang. String[ ] getTextualServiceldentif iers ( ) 

Returns the textual service identifiers related to this object. 

Returns: 

an array of String objects containing the textual service identifiers or null if none are present. 

Since: 

MHP1.0.1 
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Annex N (normative): Streamed Media API Extensions 
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Package 

org.dvb.media 



Description 

Provides DVB specific extensions to the Java Media Framework. 



Class Summary 



Interfaces 

BackgroundVideoPre- 
sentationControl 

DVBMediaSelectControl 



SubtitleListener 

SubtitlingEventCon- 
trol 

Video Format Control 



VideoFormatListener 

VideoPresentationCon- 
trol 



Classes 

ActiveFormatDescrip- 
tionChangedEvent 

AspectRatioChangedE- 
vent 

CAStopEvent 



DFCChangedEvent 
DripFeedDataSource 

DripFeedPermission 

NoComponentSelectedE- 
vent 

PresentationChangedE- 
vent 

ServiceRemovedEvent 



StopByResourceLossEv- 
ent 

SubtitleAvail- 
ableEvent 

SubtitleNotAvail- 
ableEvent 



A control to support the setting and querying of the video presentation for 
background players. 

DVBMediaSelectControl extends MediaSelectControl allowing the selec- 
tion of different kinds of content in a running Player. 

Report that a subtitle event has happened. 

Allow applications to register and unregister their interest in events related to 
the availability and presentation of subtitles. 

This provides a means for applications to get information associated with the 
format and aspect ratio of the video being presented to the user. 

The listener used to receive video format events 

A control to support setting and querying the video presentation. 



Event signalling that the transmitted active format definition has changed 

Event signalling that the aspect ratio of the transmitted video has changed 

This event is generated whenever access to a service is withdrawn by the CA 
system, e.g. 

Event signalling that the decoder format conversion being used has changed 

This class allows to create a source for a JMF player to be able to feed the 
decoder progressively with parts of a clip (e.g. 

This class represents a permission to access the drip feed mode. 

This event is generated whenever presentation of a stream stops because 
there are no selected components to present. 

This event is generated whenever the content being presented by a player 
changes for reasons outside the control of the application. 

This event is generated whenever access to a service stops because the ser- 
vice concerned has been removed from the network. 

This event is generated whenever presentation of a stream stops because the 
player has lost so many resources that it cannot continue. 

Report that subtitles are available to be presented having been unavailable. 
Inform an application that a subtitle stream has vanished from the network. 
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Class Summary 


SubtitleNotSelectedE- 


Report that subtitles are not now selected. 


vent 




SubtitleSelectedEvent 


Report that subtitles are now selected. 


Video Format Event 


The base class for all other events relating to changes in video format 


VideoTrans formation 


VideoTransformation objects express video transformations, i.e. 


Exceptions 




CAException 


This exception is thrown when access to a media stream is denied by the CA 




system. 
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org.dvb.media 

ActiveFormatDescriptionChangedE 
vent 



Declaration 

public class ActiveFormatDescriptionChangedEvent extends VideoFormatEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . media . VideoFormatEvent 

+ — org . dvb . media . ActiveFormatDescriptionChangedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Event signalling that the transmitted active format definition has changed 



Constructors 

ActiveFormatDescriptionChangedEvent(Obj ect, int) 

public ActiveFormatDescriptionChangedEvent (Java . lang .Object source, int newFormat) 

Construct the event 

Parameters: 

source - the source of the event 

newFormat - the new active format description 



Methods 

getNewFormatQ 

public int getNewFormat ( ) 

Get the new active format description 

Returns: 

the new active format description. The value of this is represented by one of the constants from 
videoFormatControi and shall be the value passed into the constructor of the event. 
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org. dvb. media 

AspectRatioChangedEvent 



Declaration 

public class AspectRatioChangedEvent extends VideoFormatEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . media . VideoFormatEvent 

+ — org . dvb . media . AspectRatioChangedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Event signalling that the aspect ratio of the transmitted video has changed 



Constructors 

AspectRatioChangedEvent(Object, int) 

public AspectRatioChangedEvent (Java. lang. Object source, int newRatio) 

Construct the event 

Parameters: 

source - the source of the event 

newRatio - the new aspect ratio of the transmitted video 



Methods 

getNewRatioQ 

public int getNewRatio ( ) 

Get the new aspect ratio of the transmitted video 

Returns: 

the new aspect ratio of the video. The value of this is represented by one of the constants from 
the VideoFormatControl class and shall be the value passed into the constructor of the event. 
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org.dvb.media 

BackgroundVideoPresentationContr 
ol 



Declaration 

public interface BackgroundVideoPresentationControl extends VideoPresentationControl 

All Superinterfaces: 

j avax .media .Control, VideoPresentationControl 

Description 

A control to support the setting and querying of the video presentation for background players. 

Methods 

getClosestMatch(VideoTransformation) 

public org . dvb .media .VideoTrans format ion getClosestMatch (org . dvb .media . VideoTr an s formation 
t) 

This method takes a video transformation and returns the closest match of that video transformation 
that can be supported for the currently selected video. If the input video transformation can be 
supported, then the output video transformation will have the same parameters as the input video 
transformation. The definition of 'closest match' is implementation dependent. 

Parameters: 

t - the input video transformation 

Returns: 

the closest match to the input video transformation. If the input video transformation is 
supported, then the input video transformation will be returned (the same instance), otherwise a 
newly created instance will be returned. 

getVideoTransformationQ 

public org . dvb .media .VideoTransformation getVideoTrans format ion ( ) 

Return the current video transformation 

Returns: 

the video transformation (clipping/scaling/positioning) that is currently used for displaying the 
video. 

setVideoTransformation(VideoTransformation) 

public boolean setVideoTransformation (org . dvb .media .VideoTransformation t) 

Sets a new video transformation (clipping/scaling/positioning). If the new video transformation is not 
supported, then the video transformation will not be changed at all (no best effort attempt is made). 

Parameters: 

t - the new video transformation 

Returns: 

true if the video transformation is supported and has been set, false otherwise. 
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org. dvb. media 

CAException 

Declaration 

public class CAException extends j ava . io . lOException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org. dvb. media .CAException 

All Implemented Interfaces: 

j ava .io.Serializable 

Description 

This exception is thrown when access to a media stream is denied by the CA system. It will typically be thrown by 
calls to DataSource.startO when access to the stream accessed by the DataSource is denied. 



Constructors 

CAExceptionQ 

public CAException ( ) 

Constructor without a reason 
CAException(String) 

public CAException (Java . lang. String reason) 

Constructor with a reason 

Parameters: 

reason - the reason why access to the stream failed 
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org. dvb. media 

CAStopEvent 

Declaration 

public class CAStopEvent extends j avax .media . StopEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I javax .media . ControllerEvent 

H j avax .media . Trans itionEvent 

I 

-I javax .media . StopEvent 

+ — org . dvb .media . CAStopEvent 

All Implemented Interfaces: 

javax .media .MediaEvent, j ava .io.Serializable 

Description 

This event is generated whenever access to a service is withdrawn by the CA system, e.g. at the end of a free 
preview period. It is not generated when an attempt to construct a Player or DataSource fails due to CA restrictions, 
or when only some of the presented content is not available or alternate content is presented. Generation of this 
event informs the application that the Player is no longer presenting any content. 



Constructors 

CAStopEvent(Controller) 

public CAStopEvent (javax .media . Controller source) 

Construct an event. 

Parameters: 

source - the controller which was presenting the service 

CAStopEvent(Controller, int, int, int, MediaLocator) 

public CAStopEvent (javax .media . Controller source, int previous, int current, int target, 
j avax .media .MediaLocator stream) 

Construct an event. 

Parameters: 

source - the controller which was presenting the service 

stream - the locator of the stream from which access has been withdrawn. 
previous - the previous state of the controller 
current - the current state of the controller 
target - the target state of the controller 
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Methods 



getStreamO 

public javax .media .MediaLocator getStreamO 

This method returns the stream from which access has been withdrawn. 



Returns: 

the locator for the stream concerned 
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org. dvb. media 

DFCChangedEvent 



Declaration 

public class DFCChangedEvent extends VideoFormatEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . media . VideoFormatEvent 

+ — org . dvb . media . DFCChangedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Event signalling that the decoder format conversion being used has changed 



Constructors 

DFCChangedEvent(Object, int) 

public DFCChangedEvent (Java . lang .Object source, int newDFC) 

Construct the event 

Parameters: 

source - the source of the event 

newDFC - the new decoder format conversion being used 



Methods 

getNewDFCO 

public int getNewDFCO 

Get the new decoder format conversion 

Returns: 

the new decoder format conversion. The value of this is represented by one of the constants from 
the VideoFormatControl class and shall be the value passed into the constructor of the event. 
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org. dvb. media 

DripFeedDataSource 

Declaration 

public class DripFeedDataSource extends javax .media . protocol . DataSource 

Java . lang .Object 

+ — j avax .media .protocol . DataSource 
I 
+ - -org . dvb . media . DripFeedDataSource 

All Implemented Interfaces: 

javax .media .protocol. Controls, javax .media .Duration 

Description 

This class allows to create a source for a JMF player to be able to feed the decoder progressively with parts of a clip 
(e.g. I or P MPEG-2 frame) according to the drip-fed mode format defined in the MHP content format chapter. 

To start using the drip-feed mode, the application needs to instantiate a player representing a MPEG-2 video 
decoder and have its source be a DripFeedDataSource instance. 

A DripFeedDataSource instance can be obtained by calling the default constructor of the class. 

A player that will be bound to a MPEG-2 video decoder (when realized) can be created with a locator of the 
following text representation: "dripfeed://". 

After having the DripFeedDataSource connected to a Player representing a MPEG-2 video decoder, the following 
rules applies: 

- If the feed method is called when the player is in the "prefetched" state the image will be stored so that when the 
player goes in the "started" state it will be automatically displayed. 

- If the feed method is called when the player is in the "started" mode, the frame shall be displayed immediately. In 
particular it is not required to feed a second frame to the decoder to display the first frame. 

- If the feed method is called when the player is in any other state (or if the DripFeedDataSource is not connected 
to a player), it will be ignored by the platform implementation. 



Constructors 



DripFeedDataSourceO 

pub 1 i c DripFeedDataSource ( ) 

Constructor. A call to the constructor will throw a security exception if the application is not granted 



the right to use the drip feed mode. 
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Methods 



connectQ 



public void connect () 

throws lOException 

This method shall not be used and has no effect. This source is considered as always connected. 

Overrides: 

connect in class DataSource 

Throws: 

j ava . io . lOException - never thrown in this sub-class 



disconnectQ 

public void disconnect ( ) 

This method shall not be used and has no effect. This source is considered as always connected. 

Overrides: 

disconnect in class DataSource 

feed(byte[l) 

public void feed(byte[] clip_part) 

This method allows an application to feed the decoder progressively with parts of a clip (e.g. I or P 
MPEG-2 frame) according to the drip-fed mode format defined in the MHP content format chapter. 
The feed method shall not be called more often than every 500ms. If this rule is not respected, 
display is not guaranteed. 

While in the prefetch state the drip feed data source is only required to corrrectly process a single 
invocation of this method where the data consists only of a single I frame. Possible additional 
invocations while in the prefetch state shall have implementation specific results. 

Parameters: 

clippart - Chunk of bytes compliant with the drip-fed mode format defined in the MHP 
content format chapter (i.e. one MPEG-2 frame with optional synctactic MPEG-2 elements). 

getContentXypeO 

public Java. lang. String getContentType ( ) 

This method shall return the content type for mpeg-2 video "drips" 

Overrides: 

getContentType in class DataSource 

Returns: 

the content type for MPEG-2 video drips 

getControl(String) 

public Java . lang. Obj ect getControl (Java . lang. String controlType) 

Obtain the object that implements the specified Class or Interface. The full class or interface name 
must be used. If the control is not supported then null is returned. 



ETSI 



507 ETSITS 101 812V1.3.1 (2003-06) 

Overrides: 

getControl in class DataSource 

Parameters: 

controiType - the full class or interface name of the requested control 

Returns: 

the object that implements the control, or null. 

getControlsQ 

public Java. lang.Object[ ] getControls ( ) 

Obtain the collection of objects that control this object. If no controls are supported, a zero length 
array is returned. 

Overrides: 

getControls in class DataSource 

Returns: 

the collection of object controls 

getDurationO 

public javax .media . Time getDuration ( ) 

This method shall not be used and has no effect. 

Overrides: 

getDuration in class DataSource 

Returns: 

DURATION UNKNOWN. 



start() 

public void start () 

throws lOException 

This method shall not be used and has no effect. This source is considered as always started. 

Overrides: 

start in class DataSource 

Tlirows: 

j ava . io . lOException - never thrown in this sub-class 



stopO 



public void stop ( ) 

throws lOException 

This method shall not be used and has no effect. This source is considered as always started. 

Overrides: 

stop in class DataSource 

Tlirows: 

j ava . io . lOException - never thrown in this sub-class 
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org. dvb. media 

DripFeedPermission 



Declaration 

public class DripFeedPermission extends Java . security . BasicPermission 

Java . lang .Object 

H j ava . security. Permission 

I 

-I Java .security. BasicPermission 

+ — org . dvb . media . DripFeedPermission 

All Implemented Interfaces: 

j ava .security. Guard, j ava .io.Serializable 

Description 

This class represents a permission to access the drip feed mode. 



Constructors 

DripFeedPermission(String) 

public DripFeedPermission (j ava . lang. String name) 

Create a new DripFeedPermission. 

Parameters: 

name - tine name string is currently unused and should be empty 

DripFeedPermission(String, String) 

public DripFeedPermission (j ava . lang. String name, j ava . lang . String actions) 

Create a new DripFeedPermission. This constructor is used by the policy class to instantiate new 
permission objects. 

Parameters: 

name - The name string is currently unused and should be empty 

actions - The actions string is currently unused and should be null. 
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Methods 



implies(Permission) 

public boolean implies (Java . security . Permission p) 

Checks if the specified permission is "implied" by this object. 

Since name and actions aren't used, the only check needed is whether p is also a 
DripFeed Permission. 

Overrides: 

implies in class BasicPermission 

Parameters: 

p - the permission to check against. 

Returns: 

true if the passed permission is equal to or implied by this permission, false otherwise. 
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org. dvb. media 

DVBMediaSelectControl 



Declaration 

public interface DVBMediaSelectControl extends javax. tv. media. MediaSelectControl 

All Superinterfaces: 

j avax .media .Control, j avax . t v. media .MediaSelectControl 

Description 

DVBMediaSelectControl extends MediaSelectControl allowing the selection of different kinds of content in 
a running Player. The extension is to allow the selection in a single operation of all the media service 
components in a service without needing knowledge about which media service components are present in that 
service. 

Since: 

MHP 1.0.2 

See Also: 

j avax . tv .media .MediaSelectControl 



Methods 



selectServiceMediaComponents(Locator) 

public void selectServiceMediaComponents (j avax . tv. locator . Locator 1) 

throws InvalidLocatorException, InvalidServiceComponentException, Insufficient 
ResourcesException 

Selects for presentation the media service components from a service. If some content is currently 
playing, it is replaced in its entirety by the media service components from the specified service. This 
is an asynchronous operation that is completed upon receipt of a MediaSelectEvent. Note that for 
most selections that imply a different time base or otherwise change synchronization relationships, a 
RestartingEvent will be posted by the Player. The rules for deciding which media service 
components shall be presented are defined in the main body of this specification. 

Parameters: 

1 - the locator for a service 

Throws: 

javax . tv. locator . InvalidLocatorException - If the locator provided does not 
reference a service. 

j avax . tv. service, selection. I nvalidServiceComponent Except ion - If the locator 
provided does not reference a service which contains at least one media service component 

j avax . tv. service, selection. Insuf ficientRe source sExcept ion - If the operation 
cannot be completed due to a lack of system resources. 
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org. dvb. media 

NoComponentSelectedEvent 

Declaration 

public class NoComponentSelectedEvent extends j avax .media . StopEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I javax .media . ControllerEvent 

H j avax .media . Trans itionEvent 

I 

-I javax .media . StopEvent 

+ — org . dvb .media . NoComponentSelectedEvent 

All Implemented Interfaces: 

javax .media .MediaEvent, j ava .io.Serializable 

Description 

This event is generated whenever presentation of a stream stops because there are no selected components to 
present. One example of this would be use of the javax. tv.media.MediaSelectControl. remove 
method to remove all components of a service. Generation of this event informs the application that the Player is no 
longer presenting any content. 

Since: 

MHP 1.0.1 



Constructors 



NoComponentSelectedEvent(Controller, int, int, int, MediaLocator) 

public NoComponentSelectedEvent (javax .media . Controller source, int previous, int current, 
int target, j avax .media .MediaLocator stream) 

Construct an event. 

Parameters: 

source - the controller which was presenting the service 

stream - the locator of the stream whose presentation has stopped 
previous - the previous state of the controller 
current - the current state of the controller 
target - the target state of the controller 
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Methods 



getStreamO 

public javax. media .MediaLocator getStreamO 

This method returns the stream whose presentation has stopped 



Returns: 

the locator for the stream concerned 
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org. dvb. media 

PresentationChangedEvent 

Declaration 

public class PresentationChangedEvent extends j avax .media . ControllerEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
-I javax .media . ControllerEvent 

+ — org . dvb . media . PresentationChangedEvent 

All Implemented Interfaces: 

j avax .media .MediaEvent, j ava .io.Serializable 

Description 

This event is generated whenever the content being presented by a player changes for reasons outside the control of 
the application. The state of the player does not change - only the content being presented. 



Fields 



CA_FAILURE 

public static final int CA_FAILURE 

Presentation changed due an action by tine CA subsystem. Alternate content is being played, not the 
content selected by the user (e.g. adverts in place of a scrambled service) 

See Also: 

getReason () 

CA_RE TURNED 

public static final int CA_RETURNED 

Presentation changed due to an action by the CA subsystem. Normal content is now being 
presented as requested by the user. This reason code is used when the CA subsystem commands 
the MHP terminal to switch back to the normal presentation after having previously selected an 
alternate content. 

See Also: 

getReason () 

STREAM_UNAVAILABLE 

public static final int STREAM_UNAVAILABLE 

The stream being presented is no longer available in the transport stream. 

See Also: 

getReason ( ) 
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Constructors 



PresentationChangedEvent(Controller, MediaLocator, int) 

public PresentationChangedEvent (javax .media . Controller source, 
j avax .media .MediaLocator stream, int reason) 

Constructor for the event 

Parameters: 

source - the controller whose presentation changed 

stream - the stream now being presented. 

reason - the reason for the change encoded as one of the constants in this class 



Methods 



getReasonO 

public int getReasonO 

This method returns the reason why access has been withdrawn. 

Returns: 

the reason for the change specified when the event was constructed 

getStreamO 

public javax. media. MediaLocator getStreamO 

This method returns the locator for the stream now being presented. 

Returns: 

the locator for the stream now being presented 
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org. dvb. media 

ServiceRemovedEvent 



Declaration 

public class ServiceRemovedEvent extends j avax .media . StopEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I javax .media . ControllerEvent 

H j avax .media . Trans itionEvent 

I 

-I javax .media . StopEvent 

+ — org . dvb .media . ServiceRemovedEvent 

All Implemented Interfaces: 

javax .media .MediaEvent, j ava .io.Serializable 

Description 

This event is generated whenever access to a service stops because the service concerned has been removed from 
the network. Generation of this event informs the application that the Player is no longer presenting any content. 

Since: 

MHP 1.0.1 



Constructors 



ServiceRemovedEvent(Controller) 

public ServiceRemovedEvent (j avax .media . Controller source) 

Construct an event. 

Parameters: 

source - the controller which was presenting the service 

ServiceRemovedEvent(Controller, int, int, int, MediaLocator) 

public ServiceRemovedEvent (javax .media . Controller source, int previous, int current, 
int target, j avax .media .MediaLocator stream) 

Construct an event. 

Parameters: 

source - the controller which was presenting the service 

stream - the locator of the stream which was removed from the network 
previous - the previous state of the controller 
current - the current state of the controller 
target - the target state of the controller 
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Methods 



getStreamO 

public javax .media .MediaLocator getStreamO 

This method returns the stream which was removed from the networl< 



Returns: 

the stream concerned 
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org. dvb. media 

StopByResourceLossEvent 

Declaration 

public class StopByResourceLossEvent extends j avax .media . StopEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I javax .media . ControllerEvent 

H j avax .media . Trans itionEvent 

I 

-I javax .media . StopEvent 

+ — org . dvb .media . StopByResourceLossEvent 

All Implemented Interfaces: 

javax .media .MediaEvent, j ava .io.Serializable 

Description 

This event is generated whenever presentation of a stream stops because the player has lost so many resources that 
it cannot continue. Generation of this event informs the application that the Player is no longer presenting any 
content. 

Since: 

MHP 1.0.1 



Constructors 



StopByResourceLossEvent(Controller, int, int, int, MediaLocator) 

public StopByResourceLossEvent (javax. media . Controller source, int previous, int current, 
int target, j avax .media. MediaLocator stream) 

Construct an event. 

Parameters: 

source - the controller which was presenting the service 

stream - the locator of the stream which was being presented 
previous - the previous state of the controller 
current - the current state of the controller 
target - the target state of the controller 
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Methods 



getStreamO 

public javax .media .MediaLocator getStreamO 

This method returns the stream which was being presented 

Returns: 

the locator for the stream concerned 
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org. dvb. media 

SubtitleAvailableEvent 



Declaration 

public class SubtitleAvailableEvent extends Java . util . EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+--org . dvb . media . SubtitleAvailableEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Report that subtitles are available to be presented having been unavailable. This event is not generated on service 
selection or other forms of 'zapping'. Its generation is restricted to changes in the composition of the subtitle 
aspects of the same broadcast stream. 



Constructors 

SubtitleAvailableEvent(Obj ect) 

public SubtitleAvailableEvent (j ava . lang. Ob j ect source) 

Constructor. 

Parameters: 

source - the source of the event. The platform shall always pass in the JMF player presenting 
the subtitles. 



Methods 

getSourceO 

public Java. lang. Object getSource ( ) 

Return the JMF player which is the source of the event. 

Overrides: 

getSource in class EventObject 

Returns: 

the source of the event. This shall be the JMF player passed in to the constructor of the event. 
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org. dvb. media 

SubtitleListener 



Declaration 

public interface SubtitleListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

Report that a subtitle event has happened. 



Methods 

subtitleStatusChanged(EventObject) 

public void subtitleStatusChanged (j ava . util . EventObject event) 

Report a subtitle event has happened. 

Parameters: 

event - the event which happened 
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org. dvb. media 

SubtitleNotAvailableEvent 



Declaration 

public class SubtitleNotAvailableEvent extends j ava . util .EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+--org . dvb . media . SubtitleNotAvailableEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Inform an application that a subtitle stream has vanished from the network. This event is not generated on service 
selection or other forms of 'zapping'. Its generation is restricted to changes in the composition of the subtitle 
aspects of the same broadcast stream. 



Constructors 

SubtitleNotAvailableEvent(Object) 

public SubtitleNotAvailableEvent (j ava . lang .Object source) 

Constructor. 

Parameters: 

source - the source of the event. The platform shall always pass in the JMF player presenting 
the subtitles. 



Methods 

getSourceO 

public Java. lang. Object getSource ( ) 

Return the source of the event. 

Overrides: 

getSource in class EventObject 

Returns: 

the source of the event. This shall be the JMF player passed in to the constructor of the event. 
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org. dvb. media 

SubtitleNotSelectedEvent 



Declaration 

public class SubtitleNotSelectedEvent extends j ava . util . EventObj ect 

Java . lang .Object 

+ — j ava . util . EventObj ect 
I 
+--org . dvb . media . SubtitleNotSelectedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Report that subtitles are not now selected. Even if subtitles are available in the network, they will not be presented. 
This event is generated when the combination of end user control of subtitles through the navigator and application 
control of subtitles through SubtitlingLanguageControl . setSubtitling changes whether subtitles 
are to be presented if they are available. It is not generated for changes in the underlying availability of subtitles 
even if those cause changes in whether subtitles are presented or not. 



Constructors 

SubtitleNotSelectedEvent(Object) 

public SubtitleNotSelectedEvent (Java. lang. Object source) 

Constructor 

Parameters: 

source - the source of the event. The platform shall always pass in the JMF player presenting 
the subtitles. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Return the source of the event 

Overrides: 

getSource in class EventObj ect 

Returns: 

the source of the event. This shall be the JMF player passed in to the constructor of the event. 
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org. dvb. media 

SubtitleSelectedEvent 



Declaration 

public class SubtitleSelectedEvent extends Java . util .EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+--org . dvb . media . SubtitleSelectedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Report that subtitles are now selected. If subtitles are also available then they will be presented. This event is 
generated when the combination of end user control of subtiles through the navigator and application control of 
subtiles through SubtitlingLanguageControl . setSubtitling changes whether subtitles are to be 
presented if they are available. It is not generated for changes in the underlying availability of subtitles even if those 
cause changes in whether subtiles are presented or not. 



Constructors 

SubtitleSelectedEvent(Obj ect) 

public SubtitleSelectedEvent (Java. lang. Object source) 

Constructor 

Parameters: 

source - the source of the event. The platform shall always pass in the JMF player presenting 
the subtitles. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Return the source of the event 

Overrides: 

getSource in class EventObject 

Returns: 

the source of the event. This shall be the JMF player passed in to the constructor of the event. 
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org. dvb. media 

SubtitlingEventControl 

Declaration 

public interface SubtitlingEventControl extends org. davic .media. SubtitlingLanguageControl 

All Superinterfaces: 

j avax .media .Control, org . davic .media .LanguageControl, 
org. davic .media . SubtitlingLanguageControl 

Description 

Allow applications to register and unregister their interest in events related to the availability and presentation of 
subtitles. 



Methods 

addSubtitleListener(SubtitleListener) 

public void addSubtitleListener (org. dvb .media . SubtitleListener 1) 

Add a listener for subtitle events 

Parameters: 

1 - the listener to report the events to 

removeSubtitleListener(SubtitleListener) 

public void removeSubtitleListener (org. dvb .media . SubtitleListener 1) 

Remove a listener for subtitle events 

Parameters: 

1 - the listener to remove 
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org. dvb. media 

VideoFormatControl 



Declaration 

public interface VideoFormatControl extends javax. media. Control 

All Superinterfaces: 

j avax .media .Control 

Description 

This provides a means for applications to get information associated with the format and aspect ratio of the video 
being presented to the user. This control will only be available for Players presenting MPEG-2 video streams. 

It is important to note that due to different video and display formats (and user preferences), not all of the full video 
frame may be displayed. Similarly, it may not always be possible to map video and graphics with perfect accuracy. 



Fields 

AFD_14_9 

public static final int AFD_14_9 

Constant representing an MPEG active format description of 14:9 (centre) 
AFD_14_9_TOP 

public static final int AFD_14_9_TOP 

Constant representing an IVIPEG active format description of 14:9 (top) 
AFD_16_9 

public static final int AFD_16_9 

Constant representing an IVIPEG active format description of 16:9 (centre) 
AFD_16_9_SP_14_9 

public static final int AFD_16_9_SP_14_9 

Constant representing an MPEG active format description of 16:9 (with shoot & protect 14:9 centre) 
AFD_16_9_SP_4_3 

public static final int AFD_16_9_SP_4_3 

Constant representing an MPEG active format description of 16:9 (with shoot & protect 4:3 centre) 
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AFD_16_9_TOP 

public static final int AFD_16_9_TOP 

Constant representing an MPEG active format description of 16:9 (top) 
AFD_4_3 

public static final int AFD_4_3 

Constant representing an IVIPEG active format description of 4:3 (centre) 
AFD_4_3_SP_14_9 

public static final int AFD_4_3_SP_14_9 

Constant representing an IVIPEG active format description of 4:3 (with shoot & protect 14:9 centre) 
AFD_GT_16_9 

public static final int AFD_GT_16_9 

Constant representing an MPEG active format description of greater than 16:9 (centre) 
AFD_NOT_PRESENT 

public static final int AFD_NOT_PRESENT 

Constant showing an MPEG active format description is not present 
AFD_SAME 

public static final int AFD_SAME 

Constant representing an MPEG active format description that is the same as the coded frame 
ASPECT_RATIO_l 6_9 

public static final int ASPECT_RATIO_16_9 

Constant representing an aspect ratio of 16:9 
ASPECT_RATIO_2_21_l 

public static final int ASPECT_RATIO„2_21_l 

Constant representing an aspect ratio of 2.21 :1 
ASPECT_RATIO_4_3 

public static final int ASPECT_RATIO_4_3 

Constant representing an aspect ratio of 4:3 
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ASPECT_RATIO_UNKNOWN 

public static final int ASPECT_RATIO_UNKNOWN 

Constant representing an unknown aspect ratio 



DAR_16_9 

public static final int DAR_16_9 

Constant representing a display aspect ratio of 16:9 



DAR_4_3 

public static final int DAR_4_3 

Constant representing a display aspect ratio of 4:3 



DFC_PLATFORM 

public static final int DFC_PLATFORM 

Control over the decoder format conversions is returned to being managed by the platform. This is 
the same as the value used if no MHP application has set a video transformation. It is not required to 
correspond to a single decoder format conversion and may change over time as the video input 
format & signalling change. This constant can only be used to set the decoder format conversion. 
Reading the decoder format conversion shall always return the DFC used at the time concerned. 

DFC_PROCESSING_16_9_ZOOM 

public static final int DFC_PROCESSING_16_9_ZOOM 

The central 16:9 letterbox area of the 4:3 720x576 input grid is expanded to fill the 16:9 output frame. 
DFC_PROCESSING_CCO 

public static final int DFC_PROCESSING_CCO 

A 4:3 central part out of the 720x576 input 16:9 frame is transferred into a 720x576 4:3 output frame 
DFC_PROCESSING_FULL 

public static final int DFC_PROCESSING_FULL 

The full 720x576 frame is transferred (this may be either 4:3 or 1 6:9; part of this may be black, e.g. in 
the "pillar box" cases) 

DFC_PROCESSING_LB_14_9 

public static final int DFC_PROCESSING_LB_14_9 

The 720x576 input grid is transferred into a 14:9 LB in a 4:3 frame 
DFC_PROCESSING_LB_16_9 

public static final int DFC_PROCESSING_LB_16_9 

The 720x576 input grid is transferred into a 16:9 letterbox in a 4:3 frame 
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DFC_PROCESSING_LB_2_21_l_ON_16_9 

public static final int DFC_PROCESSING_LB_2_21_l_ON_16_9 

The 720x576 input grid is transferred into a 2.21:1 letterbox in a 16:9 frame. 
DFC_PROCESSING_LB_2_21_l_ON_4_3 

public static final int DFC_PROCESSING_LB_2_21_l_ON_4_3 

Tiie 720x576 input grid is transferred into a 2.21 :1 letterbox in a 4:3 frame. 
DFC_PROCESSING_NONE 

public static final int DFC_PROCESSING_NONE 

Decoder format conversion is inactive 
DFC_PROCESSING_PAN_SCAN 

public static final int DFC_PROCESSING_PAN_SCAN 

A 4:3 part out of the 720x576 input 16:9 or 2.21:1 frame is transferred into a 720x576 4:3 output 
frame. The horizontal position of this part is determined by pan&scan vectors from the MPEG video 
stream. 

DFC_PROCESSING_UNKNOWN 

public static final int DFC_PROCESSING_UNKNOWN 

Constant representing an unknown format conversion being performed by the decoder 



Methods 



addVideoFormatListener(VideoFormatListener) 

public void addVideoFormatListener (org . dvb .media .VideoFormatListener 1) 

Add a listener for VideoFormatChanged Events 



Parameters: 

1 - the listener to add 



getActiveFormatDeflnitionO 

public int getActiveFormatDef inition ( ) 

Return the value of the active_format field of the MPEG Active Format Description of the video if it is 
transmitted (one of the constants AFD_* above). If this field is not available then 
AFD_NOT_PRESENT is returned. The constant values for the constants representing the Active 
Format Description should be identical to the values specified in ETR154, annex B. 

Returns: 

the value of the active_format field of the MPEG Active Format Description of the video if it is 
transmitted. If this field is not available, or the video is not MPEG, then AFD_NOT_PRESENT is 
returned. 
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getAspectRatioQ 

public int getAspectRatio ( ) 

Return the aspect ratio of the video as it is transmitted. If the aspect ratio is not l<nown, 
ASPECT_RATIO_UNKNOWN is returned 

Returns: 

the aspect ratio of the video 



getDecoderFormatConversionO 

public int getDecoderFormatConversionO 

Return a value representing what format conversion is being done by the decoder in the platform 
(one of the constants DFC_* above). A receiver may implement only a subset of the available 
options. This decoder format conversion may be active or not depending upon the mode of 
operation. 

Returns: 

the decoder format conversion being performed or DFC_PROCESSING_UNKNOWN if this is 
not known 

getDisplayAspectRatioQ 

public int getDisplayAspectRatio ( ) 

Return the aspect ratio of the display device connected to this MHP decoder (one of the constants 
DAR_* above) 

Returns: 

the aspect ratio of the display device connected to the decoder 

getVideoTransformation(int) 

public org . dvb .media .VideoTransformation getVideoTransformation (int dfc) 

This method returns a VideoTransformation object that corresponds with the specified Decoder 
Format Conversion when applied to the currently selected video. If the specified Decoder Format 
Conversion is not supported for the currently selected video, then this method returns null. 

Parameters: 

dfc - the Decoder Format Conversion (one of the DFC_* constants specified in this interface) 

Returns: 

the video transformation, or null if the specified Decoder Format Conversion is not supported for 
the currently selected video. 

isPlatformO 

public boolean isPlatform ( ) 

Test if control over the decoder format conversions is being managed by the platform as defined by 

DFC_PLATFORM. 

Returns: 

true if control over the decoder format conversions is being managed by the platform, false 
otherwise 

See Also: 

DFC PLATFORM 
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remove VideoFormatListener(VideoFormatListener) 

public void removeVideoFormatListener (org . dvb .media .VideoFormatListener 1) 

Remove a listener for VideoFormatChangedEvents 



Parameters: 

1 - the listener to remove 
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org. dvb. media 

VideoFormatEvent 



Declaration 

public abstract class VideoFormatEvent extends Java . util .EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+ - - org . dvb . media . VideoFormatEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Direct Known Subclasses: 

ActiveFormatDescriptionChangedEvent, AspectRatioChangedEvent, 
DFCChangedEvent 

Description 

The base class for all other events relating to changes in video format 



Constructors 



VideoFormatEvent(Object) 

public VideoFormatEvent (Java . lang. Object source) 

Constructor 

Parameters: 

source - the source of the event. The platform shall always pass in the JMF Player presenting 
the video whose format changed. 
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org. dvb. media 

VideoFormatListener 



Declaration 

public interface VideoFormatListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

The listener used to receive video format events 



Methods 

receive VideoFormatEvent(VideoFormatEvent) 

public void receiveVideoFormatEvent (org. dvb .media .VideoFormatEvent anEvent) 

receive a VideoFormatEvent 

Parameters: 

anEvent - the VideoFormatEvent tiiat lias been received 
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org. dvb. media 

VideoPresentationControl 



Declaration 

public interface VideoPresentationControl extends javax. media. Control 

All Superinterfaces: 

j avax .media .Control 

All Known Subinter faces: 

BackgroundVideoPresentationControl 

Description 

A control to support setting and querying the video presentation. 

Note: For a component-based player the scaling and positioning of the video is done by manipulating the 
corresponding AWT component. The VideoPresentationControl only allows for the setting of the clipping region. 

Note: If the hardware supports the positioning of interlaced video on even lines only (when counting from 0), then 
a component-based player is allowed to position the top of the video one line below where it should be. 

For a background player there is the BackgroundVideoPresentationControl that allows for the setting of the 
clipping region, the position and the scaling of the video in one atomic action. 



Fields 

POS_CAP_FULL 

public static final byte POS_CAP_FULL 

Constant representing that the video can be positioned anywhere on the screen, even if a part of the 
video is off screen as a result of that. 

POS_CAP_FULL_EVEN_LINES 

public static final byte POS_CAP_FULL_EVEN_LINES 

n Constant representing that the video can be positioned anywhere on the screen, even if a part of 
the video is off screen as a result of that, with the restriction that the field order is respected. This 
implies that interlaced video can be positioned on even lines only (when counting from 0). 

POS_CAP_FULL_EVEN_LINES_IF_ENTIRE_VIDEO_ON_SCREEN 

public static final byte POS_CAP_FULL_EVEN_LINES_IF_ENTIRE_VIDEO_ON_SCREEN 

Constant representing that the video can be positioned anywhere on screen as long as all the video 
is on screen, with the restriction that the field order is respected. This implies that interlaced video 
can be positioned on even lines only (when counting from 0). 
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POS_CAP_FULL_IF_ENTIRE_VIDEO_ON_SCREEN 

public static final byte POS_CAP_FULL_IF_ENTIRE_VIDEO_ON_SCREEN 

Constant representing that the video can be positioned anywhere on screen as long as all the video 
is on screen. 



POS_CAP_OTHER 

public static final byte POS_CAP_OTHER 

Constant representing that the video positioning capability cannot be expressed by another 
POS_CAP_* constant. 



Methods 



getActiveVideoAreaO 

public org . havi . ui . HScreenRectangle getActiveVideoArea ( ) 

This method returns the size and location of the active video area. The active video area excludes 
any "bars" used for letterboxing or pillarboxing that the receiver knows about. Bars that are included 
in the broadcast stream and not signalled by active format descriptors are included in the active 
video area. The active video area may be larger/smaller than the screen, and may possibly be offset. 
The offsets will be negative if the origin of the active video area is above/left of the top, left corner of 
the screen. In case of pan&scan, the value returned may vary over time. This method only describes 
the relationship between the active video and the screen. It does not describe which portion of the 
screen is displaying the video. 
Note: This method includes any video scaling. 

Returns: 

an HScreenRectangle representing the active video area in the normalised coordinate space. 



getActiveVideoAreaOnScreenO 

public org. havi .ui . HScreenRectangle getActiveVideoAreaOnScreen ( ) 

This method returns the size and location of the active video area on-screen. The active video area 
excludes any "bars" used for letterboxing or pillarboxing that the receiver knows about. Bars that are 
included in the broadcast stream and not signalled by active format descriptors are included in the 
active video area. The active video area on-screen may be smaller than the area of the screen, and 
may possibly be offset a positive amount. This method only describes the area on-screen where 
active video is being presented. It does not really describe which part of the video is being shown on- 
screen. This is especially true for pan&scan. 
Note: This method includes any video scaling. 

Returns: 

an HScreenRectangle representing the active video area on-screen in the normalised coordinate 
space. 

getClipRegionO 

public Java. awt .Rectangle getClipRegion () 

This method returns the area of the decoded video that will be displayed. If clipping is not supported, 
the dimensions of the bounding box will be the same as the displayed video. Note that when the 
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MHP terminal is in pan & scan mode , tiie return value of tinis metlnod will be out of date almost as 
soon as the method has returned. 

Returns: 

area of the decoded video that will be displayed. The coordinate space used to express the 
region is that of the decoded video after possible ETR154 up-sampling. 



getHorizontalScalingFactorsO 

public float [ ] getHorizontalScalingFactors ( ) 

This method gives information about the supported discrete horizontal scaling factors in case 
arbitrary horizontal scaling is not supported. 

Returns: 

an array with the supported discrete horizontal scaling factors (including the scaling factor 1), 
sorted in ascending order, null is returned when arbitrary horizontal scaling is supported. 

getlnputVideoSizeO 

public Java . awt . Dimension getlnputVideoSize ( ) 

This method returns the dimensions of the video before any scaling has taken place (but after 
ETR154 up-sampling). On 50Hz standard definition systems this method always returns 720x576. 

Returns: 

the size of the decoded video before any scaling has taken place (but after ETR154 up- 
sampling) 

getPositioningCapabilityO 

public byte getPositioningCapabilityO 

This method gives information about how the video can be positioned on screen. 

Returns: 

the positioning capability for the currently selected video as one of the POS_CAP_* constants. 

getTotalVideoAreaO 

public org . havi . ui . HScreenRectangle getTotalVideoAreaO 

This method returns a relative size and location of the total video area, including any "bars" used for 
letterboxing or pillarboxing that are included in the broadcast stream, but excluding any "bars" 
introduced as a result of video filtering. This may be larger or smaller than the size of the physical 
display device. This method only describes the relationship between the total video and the screen. It 
does not describe which portion of the screen is displaying the video. 
Note: This method includes any video scaling. 

Returns: 

an HScreenRectangle representing the total video area in the normalised coordinate space. 



getTotalVideoAreaOnScreenQ 

public org. havi . ui . HScreenRectangle getTotalVideoAreaOnScreen ( ) 

This method returns a relative size and location of the total video area on-screen, including any 
"bars" used for letterboxing or pillarboxing that are included in the broadcast stream, but excluding 
any "bars" introduced as a result of video filtering. This method only describes the area on-screen 
where total video is being presented. This does not really describe which part of the video is being 
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shown on-screen. This is especially true for pan&scan. 
Note: This method includes any video scaling. 

Returns: 

an HScreenRectangle representing the total video area on-screen in the normalised coordinate 
space. 

getVerticalScalingFactorsO 

public float [] getVerticalScalingFactorsO 

This method gives information about the supported discrete vertical scaling factors in case arbitrary 
vertical scaling is not supported. 

Returns: 

an array with the supported discrete vertical scaling factors (including the scaling factor 1), 
sorted in ascending order, null is returned when arbitrary vertical scaling is supported. 

getVideoSizeO 

public j ava . awt . Dimension getVideoSize ( ) 

This method returns the size of the decoded video as it is being presented to the user. It takes 
scaling and clipping into account. 

Returns: 

the size of the decoded video as it is being presented to the user 

setClipRegion(Rectangle) 

public Java . awt . Rectangle setClipRegion (Java . awt .Rectangle clipRect) 

Set the region of the decoded video that will be displayed. If clipping is not supported, this method 
has no effect. If the bounding box extends beyond the decoded video, the results are implementation 
dependent. By default, the clipping region is set to the dimensions of the decoded video. This 
method returns the bounding box of the clipping region that was actually set. Implementations may 
approximate the requested rectangle if they have restrictions on video clipping. 

If the player is a component-based player (as opposed to a background player), then the top left 
corner of the clip region will be aligned with the top left corner of the java.awt.Component returned by 
the method javax.media.Player.getVisualComponent(). Hence changing the position of the clip 
region within the video moves the video with respect to the coordinate space used by Java. awt. 

Parameters: 

clipRect - the bounding box of the clipping region. The coordinate space used to express the 
region is that of the decoded video after possible ETR154 up-sampling. 

Returns: 

the set clipping region. If the requested clipping region is supported exactly, then the input 
parameter clipRect is returned, otherwise a newly created object will be returned. 

supportsArbitraryHorizontalScalingO 

public float [] supportsArbitraryHorizontalScaling ( ) 

This method gives information about whether arbitrary horizontal scaling is supported for the 
currently playing video. If arbitrary horizontal scaling is supported, then an array with two elements in 
returned. The first element returns the smallest allowed scaling factor (e.g. 0.5) and the second 
element returns the largest allowed scaling factor (e.g. 4). If arbitrary horizontal scaling is not 
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supported, null is returned. In that case the method getHorizontalScalingFactors can be used to 
query which discrete scaling factors are supported. 

Returns: 

an array with the minimum and maximum allowed horizontal scaling factor, or null if arbitrary 
horizontal scaling is not supported. 



supportsArbitraryVerticalScalingO 

public float [] support sArbitraryVerticalScaling ( ) 

This method gives information about whether arbitrary vertical scaling is supported for the currently 
playing video. If arbitrary vertical scaling is supported, then an array with two elements in returned. 
The first element returns the smallest allowed scaling factor (e.g. 0.5) and the second element 
returns the largest allowed scaling factor (e.g. 2). If arbitrary vertical scaling is not supported, null is 
returned. In that case the method getVerticalScalingFactors can be used to query which discrete 
scaling factors are supported. 

Returns: 

an array with the minimum and maximum allowed vertical scaling factor, or null if arbitrary 
vertical scaling is not supported. 



supportsClippingO 

public boolean supportsClipping ( ) 

Test if the decoder supports clipping 

Returns: 

true if and only if the decoder supports clipping. 
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org. dvb. media 

VideoTransformation 



Declaration 

public class VideoTransformation 
Java . lang .Object 

+ — org . dvb .media .VideoTransformation 

Description 

VideoTransformation objects express video transformations, i.e. the clipping, the horizontal and vertical scaling 
and the position of the video. All transformations are to be applied after possible ETR154 up-sampling. 

Note: Instances of VideoTransformation can represent pan and scan, but an application cannot create such instances 
itself. An application can get a VideoTransformation representing pan and scan, by calling the 
VideoFormatControl.getVideoTransformationO method with the pan and scan Decoder Format Conversion 
constant. 



Constructors 

VideoTransformationO 

public VideoTransformationO 

Creates a VideoTransformation object witin default parameters. Clipping is disabled, both the 
horizontal and the vertical scaling factors are 1, and the video position is (0,0) in the normalised 
coordinate space. 

VideoTransformation(Rectangle, float, float, HScreenPoint) 

public VideoTransformation (Java . awt .Rectangle clipRect, float horizontalScalingFactor, 
float verticalScalingFactor, org . havi . ui . HScreenPoint location) 

Creates a VideoTransformation object with the supplied parameters. 

Parameters: 

clipRect - the bounding box of the clipping region. The coordinate space used to express the 
region is that of the decoded video after possible ETR154 up-sampling. A non-null ClipRect 
enables clipping. A null ClipRect disables it. 

horizontalScalingFactor - the horizontal scaling factor. 

verticalScalingFactor - the vertical scaling factor. 

location - the location of the video on the screen in the normalised coordinate space. 
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Methods 



getClipRegionO 

public Java. awt. Rectangle getClipRegion ( ) 

Gets the clipping region. 

Returns: 

tine bounding box of tiie clipping region. The coordinate space used to express the region is that 
of the decoded video after possible ETR1 54 up-sampling, null is returned if this video 
transformation represents pan and scan or if clipping is disabled. 



getScalingFactorsO 

public float [] getScalingFactorsO 

Gets the horizontal and vertical scaling factors. 

Returns: 

an array with two elements. The first element contains the horizontal scaling factor, the second 
element the vertical scaling factor. 

getVideoPositionO 

public org . havi . ui . HScreenPoint getVideoPositionO 

Returns the video position. 

Returns: 

the location of the video on the screen in the normalised coordinate space. 

isPanAndScanO 

public boolean isPanAndScan ( ) 

Returns whether this video transformation represents pan and scan. 

Returns: 

true is this video transformation represents pan and scan, false otherwise. 

setClipRegion(Rectangle) 

public void setClipRegion (j ava . awt . Rectangle clipRect) 

Sets the clipping region. 

If this video transformation represents pan and scan, then it will no longer represent pan and scan 
when this method is called. A non-null ClipRect enables clipping. A null ClipRect disables it. 

Parameters: 

clipRect - the bounding box of the clipping region. The coordinate space used to express the 
region is that of the decoded video after possible ETR154 up-sampling. 
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setScalingFactors(float, float) 

public void setScalingFactors (float horizontalScalingFactor, float verticalScalingFactor ) 

Sets the horizontal and vertical scaling factors. 

Parameters: 

horizontalScalingFactor - the horizontal scaling factor. 

verticalScalingFactor - the vertical scaling factor. 
setVideoPosition(HScreenPoint) 

public void setVideoPosition (org . havi . ui . HScreenPoint location) 

Sets the video position. 

Parameters: 

location - the location of the video on the screen in the normalised coordinate space. 
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Annex O (normative): Integration of the JavaTV SI API 
and DVB SI 

0.1 Introduction 

This section describes how the JavaTV Service Information API as described in [5 1] can be mapped to the data structures 
of DVB Service Information as defined in ETSI EN 300 468 [4]. Secondly this document describes how the JavaTV API 
and the DVB SI API (as described in annex M, "(normative): SI Access API" on page 410) can be integrated. 

0.2 Mapping of the JavaTV SI API to DVB SI 

This section describes for every relevant Java interface and method in the JavaTV SI API how it is mapped to the DVB 
Service Information. 

When adding a listener to monitor for changes in an SI table (or data carried in an SI table), an event shall not be 
generated for the current version of that table (or data) found in the network at the time the listener is added. Events shall 
only be generated for changes following the detection of that current version. 

0.2.1 javax.tv.service. Service 

MHP terminals normally maintain a stored list of "installed" services discovered through the process explained in Z.5, 
"How does the platfonn know which services are available?" on page 749. The Service interface shall represent the 
entries in this list and also those services which are discovered in the network but which are not yet stored in this list (see 
0.2.8.5, "getService" on page 544). 

Depending on the MHP terminal implementation, the objects implementing this interface may or may not implement the 
ServiceNumber interface as well. Furthermore, it is allowed that even within the same MHP terminal implementation, 
some objects implementing the Service interface implement the ServiceNumber while other objects implement only the 
Service interface. 

Objects implementing this interfaces and representing DVB services shall also implement the org . dvb . si . 

Text ual Se rvi eel dent ifierQuery interface. 

The methods are mapped as follows: 

0.2.1.1 getName 

Returns the name of the service as stored in the MHP terminal. Depending on the MHP terminal implementation, the end 
user may have the possibility to edit these names according to his preferences. If the contents of this field are retrieved by 
the MHP terminal by default from DVB SI, it is recommended that the MHP terminal uses the abbreviated form of the 
service name from the Service descriptor (see 4.6.1 "Use of control codes in names" in ETSI ETR 21 1 [11]). 

0.2.1.2 getServiceType 

Returns the ServiceType according to the mapping defined in section 0.2.3, "javax.tv.service. ServiceType" on page 542. 

0.2.2 javax.tv.service. navigation. ServiceComponent 

The ServiceComponent interface provides the information contained in the Component descriptors. Multilingual 
component descriptors or Data broadcast descriptors in the EIT. 

0.2.2.1 getComponentName 

If the language returned by javax. tv. service . SIManager .getP refer redLanguage corresponds to the 
language of a multilingual component descriptor or data broadcast descriptor in the EIT, return the description in that 
language. Otherwise return an implementation dependent selection between the descriptions available in the EIT. 
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0.2.2.2 



getAssociatedLanguage 



Returns the ISO 639.2 [66] language code indicating the language of the component (i.e. not necessarily the selected 
language for the name returned by getName ( ) ) from the component descriptor, multilingual component descriptor or 
data broadcast descriptor. 



0.2.2.3 



getStreamType 



Returns the stream type according to the mapping from the stream_content field and the component_type field of the 
Component descriptor or the Data broadcast descriptor to the JavaTV stream types according to 0.2.4, "javax.tv.service. 
navigation. StreamType" on page 542. 

0.2.3 javax.tv.service. ServiceType 

The DVB SI service types are defined in Table 61 of ETSI EN 300 468 [4]. These should be mapped to the JavaTV 
service types as follows. 

Table 0.1 : Mapping DVB to JavaTV service types 



DVB Service 
type code 


DVB ServiceType Description 


JavaTV Service Type 


0x01 


Digital television service 


DIGITAL_TV 


0x02 


Digital radio sound service 


DIGITAL, RADIO 


0x03 


Teletext service 


DATA_BROADCAST 


0x04 


NVOD Reference service 


NVOD_REFERENCE 


0x05 


NVOD time-shifted service 


NVOD_TIME_SHIFTED 


0x06 


IVIosaic service 


DIGITAL_TV 


0x07 


PAL coded signal 


ANALOG_TV 


0x08 


SECAIVI coded signal 


ANALOG_TV 


0x09 


D/D2-MAC 


ANALOG_TV 


OxOA 


FIVI Radio 


ANALOG, RADIO 


OxOB 


NTSC coded signal 


ANALOG_TV 


OxOC 


Data broadcast service 


DATA_BROADCAST 


0x10 


IVIHP application service 


DATA_APPLICATION 


0x00, 

OxOD...OxOF, 
0x11... OxFF 




UNKNOWN 



0.2.4 javax.tv.service. navigation. StreamType 

The DVB SI stream_content and component_type values are defined in Table 15 of ETSI EN 300 468 [4]. These should 
be mapped to the JavaTV Stream types as follows. If the component does not have an associated Component descriptor, 
but a Data broadcast descriptor, the stream type DATA shall be used. 

Table 0.2 : Mapping DVB stream & component types to JavaTV 



DVB stream_content 


DVB component_type 


JavaTV Stream type 


0x01 


0x00... Oxff 


VIDEO 


0x02 


0x00... Oxff 


AUDIO 


0x03 


0x01, 0x10... 0x1 3, 0x20... 0x23 


SUBTITLES 


0x03 


0x02 


DATA 


0x03 


0x00, 0x14. ..OxIF, 0x24. ..OxFF 


UNKNOWN 


0x04... OxOF 


0x00... OxFF 


UNKNOWN 
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0.2.5 javax.tv.service. SI Element 

This interface is implemented by objects implementing the Network, Bouquet, TransportStream, ServiceDetails, 
ServiceComponent and ProgramEvent interfaces. 

0.2.5.1 getServicelnformationType 

This method shall return the DVB_SI ServicelnformationType. 

0.2.6 javax.tv.service. SIManager 
0.2.6.1 getSupportedDimensions 

The parental rating descriptor defined in DVB SI standardizes one rating scheme that is based on age. To describe this 
DVB defined rating scheme, the getSupportedDimensions shall return an array that contains the string "DVB Age based 
rating". 

0.2.6.2 getRatingDimension 

When given the string "DVB Age based rating", this method shall return an object implementing the RatingDimension 
interface as described in section O.2.10, "javax.tv.service. RatingDimension" on page 544. 

0.2.6.3 retrieveSI Element 

When passed a locator that points to a service, an object implementing the ServiceDetails interface shall be returned. 
Locators representing program events are not supported and shall fail with an 

SIRequestFailureType ( INSUFFICIENT_RESOURCES) . 

Other types of locators are supported as defined. 

NOTE: program events can still be retrieved for specific times using the methods in j avax . tv . 
service . guide . ProgramSchedule. 

0.2.6.4 getTransports 

The object returned by this method shall implement the Transport interface as described in 0.2. 12, "javax.tv.service. 
transport. Transport" on page 545. 

0.2.6.5 filterServices 

Filtering of Services shall be supported with ServiceFilters. The SIElementFilter is required to be supported as defined in 
0.2.7, "javax.tv.service. navigation.SIElementFilter" on page 543. 

0.2.6.6 retrieveProgramEvent 

This method shall fail with a SIRequestFailureType ( INSUFFICIENT_RESOURCES) . 

NOTE: program events can still be retrieved for specific times using the methods in j avax . t v . 
service . guide . ProgramSchedule. 

0.2.7 javax.tv.service. navigation. SIElementFilter 

The SIElementFilter allows filtering of Services based on another SIElement. This filter type shall be supported for the 
Network and TransportStream objects. For other SIElement objects, the constructor may throw 
FilterNotSupportedException. 

0.2.8 javax.tv.service. navigation. ServiceDetails 

The ServiceDetails interface represents the information regarding the service as retrieved from the broadcast DVB SI. 
The object implementing this interface for DVB SI implements the CAIdentification interface according to the mapping 
defined in section 0.2.9, "javax.tv.service. navigation. CAIdentification" on page 544. These objects shall not implement 
the ServiceNumber interface. 
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0.2.8.1 getLongName 

If the language returned by javax. tv. service. SIManager . getPref erredLanguage corresponds to the 
language of a multilingual service descriptor in the SDT, return the service name in that language. Otherwise return an 
implementation dependent selection between the descriptors available in the SDT. 

0.2.8.2 getServiceType 

Returns the ServiceType according to the mapping defined in section 0.2.3, "javax. tv.service.ServiceType" on page 542. 

0.2.8.3 retrieveServiceDescription 

Shall always result in a notifyFailure of the SIRequestor object being called with the DATA_UNAVAILABLE 
SIRequestFailureType, as DVB SI does not include a service description. 

0.2.8.4 retrieveComponents 

If the language returned by javax. tv. service. SIManager . getPref erredLanguage corresponds to the 
language of a multilingual component descriptors or data broadcast descriptors in the BIT present/following table then 
the information for the ServiceComponents shall be retrieved from those descriptors. Otherwise the information for the 
ServiceComponents shall be returned from an implementation dependent selection between the descriptors available in 
the BIT present/following table. 

0.2.8.5 getService 

Calling this method for a ServiceDetails instance whose corresponding service is not in the "installed" services list 
(i.e. a new service found in the SDT which would not previously have been returned from S IManager . 
FilterServices (null ) ) shall return a Service instance and shall not return null. The implementation is 
responsible for creating this Service instance. It is implementation dependent whether this Service instance is also 
"installed" and hence whether or not it is returned by FilterServices (null) . This Service instance shall have no 
different behaviour from "installed" services apart from this. 

0.2.9 javax.tv.service. navigation. CAIdentification 

This interface shall be implemented by objects implementing the ServiceDetails, ProgramBvent or Bouquet interface. 

0.2.9.1 getCASystemlds 

Returns the array of integer values containing the CA_system_ids from the CA identifier descriptor. If the CA identifier 
descriptor is not present, returns an empty array. 

0.2.9.2 isFree 

When implemented in an object implementing the ServiceDetails or ProgramBvent interface, this method shall return 
true if and only if the free_CA_mode bit is set to "0" in the SDT or BIT entry, respectively. 

When implemented in an object implementing the Bouquet interface, this method shall return true if and only if there is 
no CA identifier descriptor present in the BAT. 

0.2. 10 javax.tv.service. RatingDimension 

The Parental rating descriptor defined in DVB SI standardizes one rating scheme that is based on age. This rating scheme 
contains 15 distinct age rating levels from 4 to 18 years. 

An object that describes this DVB defined rating scheme shall implement the methods as follows. 

0.2. 10.1 getDlmensionName 

Returns the string "DVB Age based rating". 

0.2. 10.2 getNumberOf Levels 

Returns 15. 
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0.2. 10.3 getRatingLevelDescription 

Returns an array of 2 strings of the form: 

{"Over «", "Recommended minimum age: n years"} 
where n is the input parameter + 4. 

0.2.1 1 javax.tv.service. navigation. ServiceProviderlnformation 

This interface shall be implemented by objects implementing the ServiceDetails interface. 

0.2.11.1 getProviderName 

If the language returned by javax. tv. service. SIManager . getPref erredLanguage corresponds to the 
language of a multilingual service descriptor or service descriptor in the SDT, return the provider name from that 
descriptor. Otherwise return an implementation dependent selection from the descriptors available in the SDT. 

0.2.12 javax.tv.service.transport.Transport 

The object implementing the Transport interface shall also implement the interfaces NetworkCoUection and 
BouquetCoUection. 

0.2.13 javax.tv.service.transport.Bouquet 

The Bouquet interface is implemented by an object that represents a DVB SI Bouquet. 

Objects implementing this interface shall also implement the CAIdentification interface. See 0.2.9, "javax.tv.service. 
navigation. CAIdentification" on page 544. 

0.2.13.1 getBouquetID 

Returns the integer DVB SI Bouquet ID value. 

0.2.13.2 getName 

If the language returned by javax. tv. service . SIManager . getPref erredLanguage corresponds to the 
language of a multilingual bouquet name descriptor in the BAT, return the name in that language. Otherwise return an 
implementation dependent selection from the descriptors available in the BAT. 

0.2.13.3 getLocator 

Returns an implementation dependent javax.tv.locator.Locator object that does not have a standardized external 
representation and might not be a org.davic.net.dvb.DvbLocator. 

0.2.14 javax.tv.service.transport. Network 

The Network interface is implemented by an object that represents a DVB SI Network. 

0.2.14.1 getNetworkID 

Returns the integer DVB SI Network ID value. 

0.2.14.2 getName 

If the language returned by javax. tv. service . SIManager . getPref erredLanguage corresponds to the 
language of a multilingual network name descriptor in the NIT, return the name in that language. Otherwise return an 
implementation dependent selection from the descriptors available in the NIT. 

0.2.14.3 getLocator 

Returns an implementation dependent javax.tv.locator.Locator object that does not have a standardized external 
representation and might not be a org.davic.net.dvb.DvbLocator. 
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0.2.15 javax.tv.service.transport.TransportStream 

The TransportStream interface is implemented by an object that represents a transport stream. 

0.2.15.1 getTransportStreamID 

Returns the integer DVB SI transport stream ID value. 

0.2.15.2 getDescription 

Transport streams do not have descriptions in DVB SI, so this method shall return an empty string. 

0.2.16 javax.tv.service. guide. ProgramEvent 

This interface is implemented by objects representing DVB SI Events. 

Objects implementing this interface shall also implement the CAIdentification interface. See 0.2.9, "javax.tv.service. 
navigation. CAIdentification" on page 544. 

0.2.16.1 getDuration 

Returns the duration value from the event entry in the body of the EIT. 

0.2.16.2 getStartTime 

Returns the start time value from the event entry in the body of the EIT. 

0.2.16.3 getEndTime 

Returns the end time value calculated from the start time and duration in the body of the EIT. 

0.2.16.4 getName 

If the language returned by javax. tv. service . SIManager . getPref erredLanguage corresponds to the 
language of a short event descriptor in the EIT, return the name from that descriptor. Otherwise return an implementation 
dependent selection from the descriptors available in the EIT. 

0.2.16.5 retrieveDescription 

If the language returned by javax. tv. service . SIManager .getPref erredLanguage corresponds to the 
language of a short event descriptor in the EIT, return the description from that descriptor. Otherwise return an 
implementation dependent selection from the descriptors available in the EIT. 

The description text in the ProgramEventDe script ion object is just passed through as a String containing the 
description as it was transmitted in the EIT table with just a character set mapping performed. 

Codes Ox8a and OxeOSa defined in tables A. 1 and A.2 of ETSI EN 300 468 [4] shall be mapped to the Java newline 
character, '\n'. 

0.2.16.6 getRating 

Returns the rating from the Parental rating descriptor according to the mapping defined in section 0.2. 17, "javax.tv. 
service. guide. ContentRatingAdvisory" on page 546. 

0.2.17 javax.tv.service. guide. ContentRatingAdvisory 
0.2.17.1 getDlmensionNames 

Returns an array containing the string "DVB Age based rating" as one of the elements in the array. 
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0.2.17.2 getRatingLevel 

When the parameter is "DVB Age based rating" and the parental rating descriptor contains a rating value between 0x01 
and OxOF for the current region, returns the integer rating value contained in the parental rating descriptor decremented 
by one (i.e. the value in the descriptor - 1). In other cases when the parameter is "DVB Age based rating" returns -1. 

0.2.17.3 getRatingText 

When the parameter is "DVB Age based rating" and the parental rating descriptor contains a rating value between 0x01 
and OxOF for the current region, returns a string of the form "Recommended minimum age: n years" where n is the rating 
value in the descriptor incremented by 3 (i.e. the value in the descriptor + 3). In other cases when the parameter is "DVB 
Age based rating" returns an empty string. 

NOTE: Applications wishing to present this information in languages other than English should use the 

getRatingLevel ( ) method and perform their own encoding of this for end-user presentation. 

0.2.17.4 getDisplayText 

When the parental rating descriptor contains a rating value between 0x01 and OxOF for the current region, returns a string 
that contains the string "Over n", where n is the rating value in the descriptor incremented by 3 (i.e. the value in the 
descriptor + 3), as its substring. 

NOTE: Applications wishing to present this information in languages other than English should use the 

getRatingLevel ( ) method and perform their own encoding of this for end-user presentation. 

0.2.17.5 0.2.x. 1 retrieveProgramEvent(Locator, SIRequestor) 

This method is not supported and shall fail with an SIRequestFailureType ( INSUFFICIENT_RESOURCES) . 
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0.3 Integration of the JavaTV SI API and the DVB SI API 

In order for the protocol independent service information API to be useful, there needs to be an easy and convenient way 
for applications to use the DVB specific parts when they are needed. The information provided in the protocol 
independent API is quite minimal and does not cover all the aspects of the standardized DVB Service Information nor 
access to the private extensions carried in the standard protocol. If there is no integration between these APIs and the 
application programmer needs to use a completely different API to retrieve additional information on the object retrieved 
from the protocol independent API, the usefulness of the protocol independent API is very questionable. In this case, the 
application programmer will start using only the protocol dependent API, as it provides the complete information and is 
as easy to use as the other API. 

To overcome these problems and make the protocol independent API somehow usefiil, it needs to be well integrated with 
the protocol dependent API, so that if an application uses first the protocol independent API for browsing the 
information, it can easily get additional, protocol dependent information on the objects of interest. 

The Java language provides an easy way to achieve this integration: the same objects can implement both the protocol 
independent interface as well as the protocol dependent interface. This way the application programmer only needs to 
cast the object to the protocol dependent interface and can directly call methods from the protocol specific API. 

Objects implementing the following interfaces of the DVB SI API should implement also the corresponding JavaTV SI 
API interfaces. When retrieving SI objects through the JavaTV APIs, they shall also implement the corresponding DVB 
SI API interfaces. 

The interfaces of both APIs shall be implemented on the objects as follows: 

Table 0.3 : 



org.dvb.si.SINetwork 


objects implement also 


javax.tv.service.transport.Networl< 


org.dvb.si.SIBouquet 


objects implement also 


javax.tv.service.transport.Bouquet 


org.dvb.si.SITransportStreamNIT 


objects implement also 


javax.tv.service.transport.TransportStream 


org.dvb.si.SIService 


objects implement also 


javax.tv.service. navigation. ServiceDetails 


org.dvb.si.SIEvent 


objects implement also 


javax.tv.service.guide.ProgramEvent 
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Annex P (normative): Broadcast Transport Protocol 
Access 

The Object Carousel represents the best suited protocol to carry a structure of objects. Thus, the Object Carousel 
"mimics" a remote server. 

The structure of the objects carried in an Object Carousel is identical to the structure of UU-Objects located on a remote 
DSMCC-UU Server. 

The aim of this API is to enable an application to access files encapsulated in an object carousel or accessible through a 
DSMCC interactive network. Note that the protocol is abstracted from the application viewpoint, so, objects accessible 
through this API are either objects encapsulated in an Object Carousel, or Objects located in an interactive DSMCC 
network on a remote server. 

To benefit from the fact that most of the functionalities are already covered by the java.io package, this API inherits from 
java.io and only defines the extra-functionalities pertaining to: 

a) the nature of the network (broadcast or DSMCC remote server) and its latency (e.g. possibility to asynchronously 
load the objects) 

b) the type of the objects that can be encapsulated in a carousel and that do not exist in a classical File structure. 
These are: ServiceGateway, Directory, File, Stream and StreamEvent. 

c) Definition of ServiceGateway, which defines a new namespace corresponding to the new Domain, and enables the 
mounting of a new volume. 

An application can optionally use only the classes of java.io. Alternatively/additionally applications can use additional 
classes and methods adapted to the specific nature and latency of the network (such as for example, the asynchronous 
loading of objects). 

The following, briefly explains the functionalities offered by this API 

The ServiceDomain class enables attaching to a ServiceDomain. Attachment to a serviceDomain corresponds to the 
mounting of a volume in the file hierarchy system and the loading of the Service Gateway. 

When attached to a Service Domain the DSM-CC UU-File, UU-Stream, UU-Directory and UU-StreamEvent objects are 
accessible through this API. 

The class DSMCCObject represents a UU-object. Due to the close relationship between resident files and downloaded 
files, this class inherits from the java.io. File class. The DSMCCObject class just defines the additional methods specific 
to DSMCC-UU that basically deal with asynchronous or synchronous loading of Objects. 

For the UU-Files or UU-Directory Objects, their content is accessible as it would be for a classical file system, i.e. by 
using the Java . io package (e.g. for listing the objects pointed to by a Directory object, you invoke the list ( ) 
method of the Java . io .File class, or to access the content of a UU-File, you can instantiate a File Input St ream 
to read the File, etc. ?). 

Additionally, the DSMCCStream and DSMCCStreamEvent classes define functionalities specific to the respective types 
of Objects (Stream and StreamEvent), which basically consists in accessing the attributes of these Objects. 

The DSMCCStream class provides access to the following attributes Duration, current NPT. In addition, an application 
can retrieve the list of Taps (modelized by the 'Locator' class), in order for a Player to be able to control and play that 
Stream. 

The DSMCCStreamEvent class inherits from the DSMCCStream class, and provides access to the event list attributes of 
a StreamEvent Object. In addition, the application has the possibility to subscribe the events which are present in the 
eventList. 

The AsynchronousLoadingEvent class and its subclasses represent events that are sent to a listener to notify it of the 
loading of an Object that had been activated by the application (asynchronous loading mode). 
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The StreamEvent class represents an abstraction of the real event that is generated, i.e. the streameventdescriptor, which 
enables the broadcaster to synchronize the application with the stream. This class enables the access to the content of an 
event, the content of the event being described by the StreamEventDescriptor, which is inserted in the stream in DSMCC 
sections at the transport level. 

Finally, the StreamEventListener and AsynchronousLoadingEventListener are interfaces that must be implemented by 
the application, in order for it to receive the respective StreamE vents and AsynchronousLoadingE vents. 
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Package 

org.dvb.dsmcc 



Description 

Provides extended access to files carried in the broadcast stream. It includes some extensions to java.io which are 
generic to (possibly) long-latency file systems and some concepts which are specific to the DSMCC object 
carousel. 



Class Summary 



Interfaces 

AsynchronousLoadin- 
gEventListener 

NPTListener 



Ob jectChangeEventLis- 
tener 

StreamEventListener 



Classes 

AsynchronousLoadin- 
gEvent 

DSMCCObject 

DSMCCStream 

DSMCCStreamEvent 

Insuf f icientRe- 
s our ces Event 

InvalidFormatEvent 

InvalidPathnameEvent 

LoadingAbortedEvent 



MPEGDeliveryError- 
Event 



NotEntitledEvent 

NPTDiscontinuityEvent 

NPTPresentEvent 

NPTRate 
NPTRateChangeEvent 



Listener for applications whicii perform asynclironous loading, in order to be 
informed if the loading is done or if an error has occurred. 

Objects that implement the NPTListener interface can receive NPTStatus- 

Event and NPTRateChangedEvent events. 

The objects that implements the ObjectChangeEventListener interface can 
receive ObjectChangeEvent event. 

Objects that implement the StreamEventListener interface can receive Stream- 
Event event. 



This class described an Object event which is used to notify the loading of a 
DSMCC object. 

A DSMCCObject is an object which belongs to a DSMCC ServiceDomain. 

The DSMCCStream class is used to manage DSMCC Stream Objects. 

The DSMCCStreamEvent class is used to manage DSMCC StreamEvent 
Objects. 

This event is generated if there are insufficient resources available to load a 
DSMCCObject. 

This event is generated if the format of the data received is inconsistent. 

The pathname does not exist or the ServiceDomain has been detached. 

This event will be sent to the AsynchronousEventListener when an asynchro- 
nous loading operation is aborted. 

An MPEGDeliveryErrorEvent indicates that an error (for instance, a time out or 
accessing the data would require tuning) has occurred while loading data from 
an MPEG Stream. 

This event is sent when an attempt to asynchronously load an object has failed 
because the elementary stream carrying the object is scrambled and the user 
is not entitled to access the content of the object. 

Sent when an MHP terminal detects a permanent discontinuity in NPT as 
defined in the main body of this specification. 

Sent to listeners on a DSMCCStream object when NPT newly appears for that 
DSMCC stream when it was not previously present. 

Represents the rate at which an NPT time-base progresses. 

Sent only when the rate of an NPT time-base changes value. 



ETSI 



552 



ETSITS 101 812V1.3.1 (2003-06) 



Class Summary 



NPTRemovedEvent 

NPTStatusEvent 

Ob jectChangeEvent 

Se rver Deliver yError- 
Event 

Service Domain 
ServiceXFRErrorEvent 
ServiceXFRRef erence 

StreamEvent 
SuccessEvent 

Exceptions 

DSMCCException 

IllegalObjectTypeEx- 
ception 

Insuf f icientResource- 
sException 

InvalidAddressExcep- 
tion 

I nvalidFormat Excep- 
tion 

InvalidPathNameExcep- 
tion 

MPEGDeliveryException 



NotEntitledException 

NothingToAbortExcep- 
tion 

NotLoadedException 



Se rver Deliver yExcep- 
tion 

ServiceXFRException 



UnknownEventException 



Sent to listeners on a DSMCCStream object when NPT which was present for 
that DSIVICC streann is removed. 

Sent when an MHP terminal detects a change of status in the NPT of a 
stream. 

This class describes an object change event that is used to monitor the arrival 
of a new version of a DSMCCOb j ect. 

The local machine can not communicate with the server. 

A ServiceDomain represents a group of DSMCC objects. 

The object requested is available in an alternate ServiceDomain. 

A ServiceXFRReference object is used when a DSIVICC Object can not be 
loaded in the current ServiceDomain but is available in an alternate Service- 
Domain. 

This class describes a Stream event which is used to synchronize an applica- 
tion with an MPEG Stream. 

This event indicates that the asynchronous loading was successful. 



The DSMCCException is the root class of all DSMCC related exceptions 

This Exception is thrown when the application attempted to create a DSM- 
CCStream or DSMCCStreamEvent object with an object or a path that did not 
correspond to a DSMCC Stream or DSMCC StreamEvent respectively 

This exception gets thrown when a request to perform a DSMCC related oper- 
ation cannot be completed due to resource limitations. 

An InvalidAddressException is thrown when the format of an NSAP address is 
not recognized. 

An InvalidFormatException is thrown when an inconsistent DSMCC message 
is received. 

The InvalidPathNameException is thrown when the path name to a DSMC- 
CObject does not exist or if the ServiceDomain has been detached. 

An MPEGDEIiveryException is thrown when an error (for instance, a time out 
or accessing the data would require tuning) occurs while loading data from an 
MPEG Stream. 

This Exception is thrown when the user is not entitled to access the content of 
the object (the Elementary Stream is scrambled and the user is not entitled). 

A NothingToAbortException is thrown when the abort method is called and 
there is no loading in progress. 

A NotLoadedException is thrown when the Stream object constructor is called 
with a DSMCC Object which is not loaded. 

A ServerDeliveryException is thrown when the local machine can not commu- 
nicate with the server. 

A ServiceXFRException is thrown when a DSMCC Object can not be loaded in 
the current ServiceDomain but is available in an alternate ServiceDomain (i.e. 

The UnknownEventException is thrown when a method tries to access to 
an unknown event. 
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org.dvb.dsmcc 

AsynchronousLoadingEvent 



Declaration 

public abstract class AsynchronousLoadingEvent extends Java . util .EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+--org . dvb . dsmcc .AsynchronousLoadingEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Direct Known Subclasses: 

Insuf f icientResourcesEvent, InvalidFormatEvent, InvalidPathnameEvent, 
LoadingAbortedEvent, MPEGDeliveryErrorEvent, NotEntitledEvent, 
ServerDeliveryErrorEvent, ServiceXFRErrorEvent, SuccessEvent 

Description 

This class described an Object event which is used to notify the loading of a DSMCC object. 



Constructors 

AsynchronousLoadingEvent(DSMCCObject) 

public AsynchronousLoadingEvent (org. dvb . dsmcc . DSMCCObject o) 

Creates an AsynchronousLoadingEvent. 

Parameters: 

o - the DSMCCObject that generated the event. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that generated the event. 

Overrides: 

getSource in class EventObject 

Returns: 

the DSMCCObject that generated the event. 
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org.dvb.dsmcc 

AsynchronousLoadingEventListener 

Declaration 

public interface AsynchronousLoadingEventListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

Listener for applications which perform asynchronous loading, in order to be informed if the loading is done or if 
an error has occurred. 



Methods 

receiveEvent(AsynchronousLoadingEvent) 

public void receiveEvent (org . dvb . dsmcc . AsynchronousLoadingEvent e) 

Method called when an event is sent to the application. 

Parameters: 

e - an AsynchronousLoadingEvent event. 
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org.dvb.dsmcc 

DSMCCException 



Declaration 

public class DSMCCException extends Java . io . lOException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

All Implemented Interfaces: 

Java .io.Serializable 

Direct Known Subclasses: 

IllegalObjectTypeException, Insuf f icientResourcesException, 
InvalidAddressException, InvalidFormatException, InvalidPathNameException, 
MPEGDeliveryException, NotEntitledException, NothingToAbortException, 
NotLoadedException, ServerDeliveryException, ServiceXFRException, 
UnknownEventException 

Description 

The DSMCCException is the root class of all DSMCC related exceptions 



Constructors 

DSMCCExceptionO 

public DSMCCExceptionO 

Construct a DSMCCException with no detail message 
DSMCCException(String) 

public DSMCCException (j ava . lang. String s) 

Construct a DSIVICCException witin the specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

DSMCCObject 

Declaration 

public class DSMCCObject extends java.io.File 

Java . lang .Object 

H j ava . io . File 

I 

+--org . dvb . dsmcc . DSMCCObject 

All Implemented Interfaces: 

j ava .io.Serializable 

Description 

A DSMCCObject is an object which belongs to a DSMCC ServiceDomain. As soon as a ServiceDomain has been 
attached to the file system hierarchy, DSMCCObject objects can be created to access the ServiceDomain objects. 

A DSMCCObject is specified by a pathname, which can either be an absolute pathname or a relative pathname. 
Relative paths shall work as defined in "Broadcast Transport Protocol Access API" in the main body of the 
specification. Path names must follow the naming conventions of the host platform. The constructors of this class 
shall accept the absolute paths returned by java.io.File.getAbsolutePath(). 

To access the content of the object: 

• For a Directory, the method list of the java.io.File class has to be used to get the entries of the directory. 

• For a Stream object, the class DSMCCStream has to be used. 

• For a File, the Java. io.FilelnputStream class or the java.io.RandomAccessFile has to be used. 
NB : 

• Obviously, for the Object Carousel, the write mode of java.io.RandomAccessFile is not allowed. 
DSMCCObjects exist in two states, loaded and unloaded as returned by the isLoaded method. Transitions from 
unloaded to loaded are triggered by applications calling the asynchronousLoad or synchronousLoad or 
getSigners(boolean) methods. Transitions from loaded to unloaded are triggered by applications calling the unload 
method. Attempting to load an already loaded object does not cause it to be re -loaded. 

The only state transitions for a DSMCCObject shall be only in response to these method calls. There shall be no 
implicit state transitions in either direction. When the application no longer has any references to an object in the 
loaded state, the system resources allocated should be freed by the system. 

The state machine of DSMCCObject is disconnected from any state model of the cache of an MHP receiver's 
DSMCC client. Objects may appear in that cache without any corresponding DSMCCObject being in the loaded 
state. Objects which are in that cache and where any corresponding DSMCCObject is not in the loaded state may 
disappear from that cache at any time. The contents of a object may be accessible to applications from the cache 
without the DSMCCObject ever being in the loaded state. 

NOTE: DSMCCObjects in the loaded state will consume memory in the MHP receiver. If memory in the MHP 
receiver is short, this memory can only be recovered by the receiver killing the MHP application. Applications 
which can accept weaker guarantees about the data of a DSMCCObject being available should use the prefetch 
methods. 

See Also: 

ServiceDomain 
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Fields 



FROM_CACHE 

public static final int FROM_CACHE 

Constant to indicate tinat tine data for an object sinall only be retrieved winere it is already in cache and 
meets the requirements of cache priority signaling. Where data is not in the cache, or the contents 
don't meet the requirements of the of cache priority signaling (i.e. cache priority signalling indicates 
that an object re-acquisition is required), attempts to load a DSMCCObject shall fail with 
MPEGDeliveryException or MPEGDeliveryErrorEvent for synchronousLoad and 



asynchronousLoad respectively. 

Since: 

MHP 1.0.1 



FROM_CACHE_OR_STREAM 

public static final int FROM_CACHE_OR_STREAM 

Constant to indicate that the data for an object shall be automatically be retrieved from the network 
where the data is not already cached. Note that this method does not modify the caching policy 
controlled by the signaling in the OC. So, if the data is signalled as requiring transparent caching 
then data will be retrieved from the network if required. 

Since: 

MHP 1.0.1 



FROM_STREAM_ONLY 

public static final int FROM_STREAM_ONLY 

Constant to indicate that the data for an object shall always be retrieved from the network even if the 
data has already been cached. 

Since: 

MHP 1.0.1 



Constructors 



DSMCCObject(DSMCCObject, String) 

public DSMCCObject (org. dvb.dsmcc .DSMCCObject dir, j ava . lang. String name) 

Create a DSMCCObject object. 

Parameters: 

dir - the directory object. 

name - the file pathname. 
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DSMCCObject(String) 

public DSMCCObject (Java. lang. String path) 

Create a DSMCCObject object. 

Parameters: 

path - the path to the file. 



DSMCCObject(String, String) 

public DSMCCObject (Java . lang . String path, j ava . lang. String name) 

Create a DSMCCObject object. 

Parameters: 

path - the directory Path. 

name - the file pathname. 



Methods 



abortQ 



public void abort () 

throws NothingToAbortException 

This method is used to abort a load in progress. It can be used to abort either a synchronousLoad or 
an asynchronousLoad. 

Throws: 

NothingToAbortException -There is no loading in progress. 



addObj ectChangeEventListener(Obj ectChangeEventListener) 

public void addObjectChangeEventListener (org . dvb . dsmcc .ObjectChangeEventListener listener) 
throws InsufficientRe sour cesExcept ion 

Subscribes an ObjectChangeEventListener to receive notifications of version changes of 
DSMCCObject. 

This listener shall never be fired until after the object has successfully entered the loaded state for 
the first time. Hence objects which never successfully enter the loaded state (e.g. because the object 
cannot be found) shall never have this listener fire. Once an object has successfully entered the 
loaded state once, this event shall continue to be fired when changes are detected by the MHP 
regardless of further transitions in or out of the loaded state. 

NOTE: The algorithm used for this change monitoring is implementation dependent. In some 
implementations, this exception will always be thrown. In other implementations, it will never be 
thrown. In other implementations, whether it is thrown or not will depend on the complexity and 
design of the object carousel in which the object is carried. Even where no exception is thrown, 
implementations are not required to detect all possible forms in which an object may change. 

Parameters: 

listener - the ObjectChangeEventListener to be notified . 

Throws: 

insuf f icientResourcesException - if there are not sufficient resources to monitor the 
object for changes. 
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asynchronousLoad(AsynchronousLoadingEventListener) 

public void asynchronousLoad (org . dvb . dsmcc . AsynchronousLoadingEventListener 1) 
throws InvalidPathNameException 

This method is used to asynchronously load a carousel object. This method can fail either 
asynchronously with an event or synchronously with an exception. When it fails synchronously with 
an exception, no event shall be sent to the listener. For each call to this method which returns without 
throwing an exception, one of the following events will be sent to the application (by a listener 
mechanism) as soon as the loading is done or if an error has occurred: SuccessEvent, 
InvalidFormatEvent, InvalidPathNameEvent, MPEGDeliveryErrorEvent, ServerDeliveryErrorEvent, 
ServiceXFRErrorEvent, NotEntitledEvent, LoadingAbortedEvent, InsufficientResourcesEvent. 

Parameters: 

1 - an AsynchronousLoadingEventListener to receive events related to asynchronous loading. 

Throws: 

InvalidPathNameException - the Object can not be found, or the serviceDomain isn't in a 
attached state. 



getSignersQ 

public Java. security . cert .X509Certif icate[ ][ ] getSignersO 

This method shall attempt to validate all certificate chains found for this file in the network. Valid 
chains do not need to originate from root certificates known to the MHP terminal, e.g. self signing of 
data files. Applications should note that calls to this method may take some time. If the 
DSMCCObject is not loaded, this method will return null. If the DSMCCObject is loaded but not 
authenticated this method will return an outer array of size zero. If the DSMCCObject is loaded, this 
method returns the same as getSigners(false), except if getSigners(false) would throw an exception, 
this method will return an outer array of size zero. 

NOTE: If the file in the network changes between when it was loaded and when the hash file(s), 
signature & certificate files are read and those files have been updated to match the new version of 
the file then the hash value of the data which was loaded will not match the hash value in the hash 
file in the network and hence no certificate chains will be valid. 

Returns: 

a two-dimensional array of X.509 certificates, where the first index of the array determines a 
certificate chain and the second index identifies the certificate within the chain. Within one 
certificate chain the leaf certificate is first followed by any intermediate certificate authorities in 
the order of the chain with the root CA certificate as the last item. 

Since: 

MHP 1.0.1 



getSigners(boolean) 

public Java. security . cert .X509Certif icate[ ][ ] getSigners (boolean known_root) 

throws InvalidFormatException, InterruptedlOException, MPEGDeliveryException, 
ServerDeliveryException, InvalidPathNameException, NotEntitledException, Servi 
ceXFRException, Insuf f icientResourcesException 

This method shall attempt to validate all certificate chains found for this file in the network. The 
known_root parameter to the method defines whether the MHP terminal shall check if the root 
certificate in each chain is known to it or not. If the root certificate is checked then chains with 
unknown root certificates shall not be considered to be valid. If root certificates are not checked then 
the MHP application is responsible for comparing them with some certificate which it provides (e.g. 
for self signing of data files). The hash file(s), signature & certificate files shall be shall be fetched 
from the network in compliance with the caching priority defined in the main body of this 
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specification. If tine object is in tine loaded state then the data of the file which was loaded shall be 
used and no new file contents loaded. If the object is not in the loaded state then this method shall 
attempt to load it as if synchronousLoad had been called. Applications should note that calls to this 
method may take some time. 

NOTE: If the file in the network changes between when it was loaded and when the hash file(s), 
signature & certificate files are read and those files have been updated to match the new version of 
the file then the hash value of the data which was loaded will not match the hash value in the hash 
file in the network and hence no certificate chains will be valid. 

Parameters: 

known_root - if true then valid certificate chains are only those where the root is known to the 
MHP terminal. If false, the validity of the chain shall be determined without considering whether 
the root is known to the MHP terminal or not. 

Returns: 

a two-dimensional array of X. 509 certificates, where the first index of the array determines a 
certificate chain and the second index identifies the certificate within the chain. Within one 
certificate chain the leaf certificate is first followed by any intermediate certificate authorities in 
the order of the chain with the root CA certificate as the last item. If no certificate chains are 
found to be valid then an outer array of size zero shall be returned. 

Throws: 

j ava . io . interruptediOException - the loading has been aborted. 

invaiidPathNameException - the Object can not be found, or the serviceDomain isn't in a 
attached state. 

NotEntitiedException - the stream carrying the object is scrambled and the user has no 
entitlements to descramble the stream. 

ServiceXFRException - the lOR of the object or one of its parent directories is a Lite Option 
Profile Body. 

invaiidFormatException - an inconsistent DSMCC message has been received. 

MPEGDeliveryException - an error has occurred while loading data from MPEG stream such 
as a timeout 

ServerDeliveryException - when an MHP terminal cannot communicate with the server for 
files delivered over a bi-directional IP connection. 

insuf f icientResourcesException - there is not enough memory to load the object 

Since: 

MHP 1.0.3 



getURLO 

public Java. net. URL getURL ( ) 

Returns a URL identifying this carousel object. If the directory entry for the object has not been 
loaded then null shall be returned. 

Returns: 

a URL identifying the carousel object or null 

Since: 

MHP 1.0.1 
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isLoadedO 

public boolean isLoadedO 

Returns a boolean indicating winetiier or not the DSIVICCObject lias been loaded. 

Returns: 

true if the file is already loaded, false otherwise. 

isObjectKindKnownQ 

public boolean isOb jectKindKnown ( ) 

Returns a boolean indicating if the kind of the object is known. (The kind of an object is known if the 



directory containing it is loaded). 

Returns: 

true if the type of the object is known, false otherwise. 



isStreamQ 

public boolean isStreamO 

Returns a boolean indicating whether or not the DSMCCObject is a DSMCC Stream object. 

Returns: 

true if the file is a stream, false if the object is not a stream or if the object kind is unknown. 



isStreamEventO 

public boolean isStreamEventO 

Returns a boolean indicating whether or not the DSMCCObject is a DSMCC StreamEvent object. 
NB: If isStreamEvent is true then isStream is true also. 

Returns: 

true if the file is a stream event, false if the object is not a stream event or if the object kind is 
unknown. 



loadDirectoryEntry(AsynchronousLoadingEventListener) 

public void loadDirectoryEntry (org . dvb . dsmcc . AsynchronousLoadingEventListener 1) 
throws InvalidPathNameException 

Asynchronous loading of the directory entry information. Calling this is equivalent of calling the 
method asynchronousLoad on the parent directory of a DSMCCObject. This method can fail 
either asynchronously with an event or synchronously with an exception. When it fails synchronously 
with an exception, no event shall be sent to the listener. 

Parameters: 

1 - a listener which will be called when the loading is done. 

Throws: 

InvalidPathNameException - if the object cannot be found. 
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prefetch(DSMCCObject, String, byte) 

public static boolean prefetch (org . dvb . dsmcc . DSMCCObject dir, Java . lang. String path, 
byte priority) 

Calling this method will issue a hint to the MHP for pre-fetching the object data for that DSMCC 
object into cache. 

Parameters: 

dir - the directory object in which to pre-fetch the data. 

path - the relative path name of object to pre-fetch, starting from the directory object passes as 
parameter. 

priority - the relative priority of this pre-fetch request (higher = more important) 

Returns: 

true if the MHP supports pre-fetching (i.e. will try to process the request) and false otherwise. 
Note that a return value of 'true' is only an indication that the MHP receiver supports pre- 
fetching. It is not a guarantee that the requested data will actually be loaded into cache as the 
receiver may decide to drop the request in order to make resources available for regular load 
requests. 



prefetch(String, byte) 

public static boolean prefetch (Java . lang . String path, byte priority) 

Calling this method will issue a hint to the MHP for pre-fetching the object data for that DSMCC 
object into cache. 

Parameters: 

path - the absolute pathname of the object to pre-fetch. 

priority - the relative priority of this pre-fetch request (higher = more important) 

Returns: 

true if the MHP supports pre-fetching (i.e. will try to process the request) and false otherwise. 
Note that a return value of 'true' is only an indication that the MHP receiver supports pre- 
fetching. It is not a guarantee that the requested data will actually be loaded into cache as the 
receiver may decide to drop the request in order to make resources available for regular load 
requests. 

removeObj ectChangeEventListener(Obj ectChangeE ventListener) 

public void removeOb jectChangeEventListener (org. dvb .dsmcc .ObjectChangeEventListener 
listener) 

Unsubscribes an ObjectChangeEventListener to receive notifications of version changes of 
DSMCCObject. 

Parameters: 

listener - a previously registered ObjectChangeEventListener. 

setRetrievalMode(int) 

public void setRetrievalMode (int retrieval_mode) 

Set the retrieval mode for a DSMCCObject. The default retrieval mode is 
FROM_CACHE_OR_STREAM. The retrieval mode state is sampled when the object is loaded 
(whether explicitly or as described in "Constraints on the java.io.File methods for broadcast 
carousels"). Changing the retrieval mode for a loaded object has no effect until the object is unloaded 
and loaded again. 



ETSI 



563 ETSITS 101 812V1.3.1 (2003-06) 



Parameters: 

retrievaimode - the retrieval mode to be used for the object specified as one of the public 
static final constants in this class. 

Throws: 

j ava . lang . iiiegaiArgumentException - if the retrievaLmode specified is not one listed 
defined for use with this method. 

Since: 

MHP 1.0.1 



synchronousLoadO 

public void synchronousLoadO 

throws InvalidFormatException, InterruptedlOException, MPEGDeliveryException, 
ServerDeliveryException, InvalidPathNameException, NotEntitledException, Servi 
ceXFRException, Insuf f icientResourcesException 

This method is used to load a DSMCCObject. This method blocks until the file is loaded. It can be 
aborted from another thread with the abort method. In this case the InterruptedlOException is 
thrown. If the lOR of the object itself or one of its parent directories is a Lite Option Profile Body, the 
MHP implementation will not attempt to resolve it : a ServiceXFRException is thrown to indicate to 
the application where the DSMCCObject is actually located. 

Throws: 

j ava . io . InterruptedlOException - the loading has been aborted. 

InvalidPathNameException - the Object can not be found, or the serviceDomain isn't in a 
attached state. 

NotEntitledException - the stream carrying the object is scrambled and the user has no 
entitlements to descramble the stream. 

ServiceXFRException - the lOR of the object or one of its parent directories is a Lite Option 
Profile Body. 

InvalidFormatException - an inconsistent DSMCC message has been received. 

MPEGDeliveryException - an error has occurred while loading data from MPEG stream such 
as a timeout 

ServerDeliveryException - when an MHP terminal cannot communicate with the server for 
files delivered over a bi-directional IP connection. 

Insufficient Re sour cesException 



unloadO 

public void unload ( ) 

throws NotLoadedException 

When calling this method, the applications gives a hint to the MHP that if this object is not consumed 
by another application/thread, the system can free all the resources allocated to this object. It is 
worth noting that if other clients use this object (e.g. a file input stream is opened on this object or if 
the corresponding stream or stream event is being consumed) the system resources allocated to this 
object will not be freed. This method puts the DSMCCObject into the unloaded state. 

Throws: 

NotLoadedException - the carousel object is not loaded. 
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org.dvb.dsmcc 

DSMCCStream 



Declaration 

public class DSMCCStream 
Java . lang .Object 

+ — org . dvb . dsmcc . DSMCCStream 

Direct Known Subclasses: 

DSMCCStreamEvent 

Description 

The DSMCCStream class is used to manage DSMCC Stream Objects. The BIOP::Stream message shall be read 
from the network once only, before the constructor of this class returns. Hence methods which return information 
from that message shall not be affected by any subsequent changes to that information. 

See Also: 

DSMCCObject 

Constructors 

DSMCCStream(DSMCCObj ect) 

public DSMCCStream (org. dvb. dsmcc. DSMCCObject aDSMCCOb ject ) 

throws NotLoadedException, IllegalOb jectTypeException 

Creates a Stream Object from a DSMCC Object. The BlOP message referenced by the 
DSMCCObject has to be a Stream or StreamEvent BlOP message. 

Parameters: 

aDSMCCOb ject - the DSMCC object which describes the stream 

Throws: 

NotLoadedException - the DSMCCObject is not loaded. 

IllegalOb j ectTypeException - the DSMCCObject is neither a DSMCC Stream nor a 
DSMCCStreamEvent 

DSMCCStream(String) 

public DSMCCStream(j ava . lang . String path) 

throws lOException, IllegalOb jectTypeException 

Create a Stream Object from its pathname. For an object Carousel, this method will block until the 
module which contains the object is loaded. The BlOP message referenced by the DSMCCObject 
pointed to by the parameter path has to be a Stream or StreamEvent BlOP message. 

Parameters: 

path - the pathname of the DSMCCStream Object. 

Throws: 

j ava . io . lOException - If an 10 error occurred. 

IllegalOb j ectTypeException - the DSMCCObject is neither a DSMCC Stream nor a 
DSMCCStreamEvent 
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DSMCCStream(String, String) 

public DSMCCStream( Java . lang . String path, j ava . lang. String name) 
throws lOException, IllegalOb jectTypeException 

Create a DSMCCStream from its pathname. For an object Carousel, this method will block until the 
module which contains the object is loaded. The BlOP message referenced by the DSMCCObject 
pointed to be the parameters path and name has to be a Stream or StreamEvent BlOP message. 

Parameters: 

path - the directory path. 

name - the name of the DSMCCStream Object. 

Throws: 

j ava . io . lOException - If an 10 error occurred. 

IllegalOb j ectTypeException - the DSMCCObject is neither a DSMCC Stream nor a 
DSMCCStreamEvent 



Methods 



addNPTListener(NPTListener) 

public void addNPTListener (org . dvb . dsmcc .NPTListener 1) 

Add a listener to NPT events on the DSMCCStream object. Adding the same listener a second time 
has no effect. 

Parameters: 

1 - the listener 

Since: 

MHP 1.0.1 



getDurationO 

public long getDurationO 

This function returns the duration in milliseconds of the DSMCC Stream. If the DSMCCStream BlOP 
message doesn't specify duration, zero will be returned. 

Returns: 

The duration in milliseconds of the DSMCC Stream. 



getNPTO 



public long getNPTO 

throws MPEGDeliveryException 

This function is used to get the current NPT in milliseconds. Implementations are not required to 
continuously monitor for NPT. In implementations which do not continuously monitor, this method will 
block while the current NPT is retrived from the stream. 

Returns: 

the current NPT in milliseconds or zero if DSMCC Stream object BlOP message doesn't contain 
any taps pointing to NPT reference descriptors. 

Tlirows: 

MPEGDeliveryException - if there's an error in retrieving NPT reference descriptors 
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getNPTRateO 

public org.dvb.dsmcc.NPTRate getNPTRateO 

throws MPEGDeliveryException 

Get the NPT rate for the DSMCCStream object. Returns null if the DSMCC stream has no associated 
NPT rate (i.e. no STR_NPT_USE tap in the list of taps). 

Returns: 

the NPT rate or null 

Throws: 

throws - MPEGDeliveryException if there's an error in retrieving NPT reference descriptors 

MPEGDeliveryException 

Since: 

MHP 1.0.1 



getStreamLocatorO 

public org . davic. net . Locator getStreamLocatorO 

This function returned a Locator referencing the streams of this collection. The interpretation of the 



return value is determined by the isMPEGProgram method. 

Returns: 

a locator. 



isAudioQ 

public boolean isAudio ( ) 

This function returns a boolean indicating if the Stream Object refers to an audio stream. This is the 
case if the audio field in the Stream(Event) BlOP message has a value different from zero. 

Returns: 

true only if the Stream object refers to an audio stream 



isDataO 

public boolean isDataO 

This function returns a boolean indicating if the Stream Object refers to a data stream. This is the 
case if the data field in the Stream(Event) BlOP message has a value different from zero. 

Returns: 

true only if the Stream object refers to a data stream 

isMPEGProgramO 

public boolean isMPEGProgram ( ) 

This method will return true if the Stream(Event) BlOP message contains a tap with use field 
BIOP_PROGRAM_USE, otherwise it will return false. 

Returns: 

true only if the Stream(Event) BlOP message is as described above 
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isVideoQ 

public boolean isVideo ( ) 

This function returns a boolean indicating if tine Stream Object refers to an video stream. Tiiis is tine 
case if tine "video' field in the Stream(Event) BlOP message has a value different from zero otherwise 
false is returned. 

Returns: 

true only if the Stream object refers to an video stream 



removeNPTListener(NPTListener) 

public void removeNPTListener (org . dvb . dsmcc .NPTListener 1) 

Remove a listener to NPT events on the DSMCCStream object. Removing a non-subscribed listener 
has no effect. 

Parameters: 

1 - the listener to remove 

Since: 

MHP 1.0.1 
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org.dvb.dsmcc 

DSMCCStreamEvent 



Declaration 

public class DSMCCStreamEvent extends DSMCCStream 

Java . lang .Object 

+ — org . dvb . dsmcc . DSMCCStream 
I 
+--org . dvb . dsmcc . DSMCCStreamEvent 

Description 

The DSMCCStreamEvent class is used to manage DSMCC StreamEvent Objects. Applications wishing to monitor 
changes in the list of events which are part of this stream event should use 

DSMCCObject . addObjectChangeEventListener on the DSMCCObject representing which describes 
this set of stream events. The BIOP::StreamEvent message shall be read from the network once only, before the 
constructor of this class returns. Hence methods which return information from that message shall not be effected 
by any subsequent changes to that information. 

The subscribe method only verifies that the event name can be bound to an eventid but it does not require that the 
stream event descriptors for that event id can be received at that moment. While the event listener is registered the 
MHP terminal shall filter the stream event descriptors as specified in Monitoring strem eventt in the main body of 
the specification. 

Constructors 



DSMCCStreamEvent(DSMCCObj ect) 

public DSMCCStreamEvent (org. dvb. dsmcc. DSMCCObject aDSMCCOb ject ) 

throws NotLoadedException, IllegalOb jectTypeException 

Create a DSMCCStreamEvent from a DSMCCObject. The Object has to be a DSMCC 
StreamEvent. 

Parameters: 

aDSMCCOb j ect - the DSMCC object which describes the stream. 

Throws: 

NotLoadedException - the DSMCCObject is not loaded. 

IllegalOb j ectTypeException - the DSMCCObject does not lead to a DSMCC 
StreamEvent. 

DSMCCStreamEvent(String) 

public DSMCCStreamEvent (Java . lang . String path) 

throws lOException, IllegalOb jectTypeException 

Create a DSMCCStreamEvent Object from its pathname. The path has to lead to a 
DSMCCStreamEvent. 

Parameters: 

path - the pathname of the DSMCCStreamEvent object 

Throws: 

j ava . io . lOException - An 10 error has occurred. 

IllegalOb j ectTypeException - the path does not lead to a DSMCC StreamEvent. 
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DSMCCStreamEvent(String, String) 

public DSMCCStreainEvent (Java . lang . String path, Java . lang . String name) 
throws lOException, IllegalOb jectTypeException 

Create a DSMCCStreamEvent from its pathname. For an object Carousel, this method will block until 
the module which contains the object is loaded. The path has to lead to a DSMCC Stream Event 

Parameters: 

path - the directory path. 

name - the name of the DSMCCStreamEvent Object. 

Throws: 

j ava . io . lOException - If an 10 error occurred. 

IllegalOb jectTypeException - the path does not lead to a DSMCC StreamEvent. 



Methods 



getEventListO 

public Java . lang. String[ ] getEventListO 

This function is used to get the list of the events of the DSMCCStreamEvent object. 



Returns: 

The list of the eventName. 



subscribe(String, StreamEventListener) 

public int siibscribe (j ava . lang . String eventName, org . dvb . dsmcc . StreamEventListener 1) 
throws UnknownEventException, Insuf f icientResourcesException 

This function is used to subscribe to an event of a DSMCC StreamEvent object. 

Parameters: 

eventName - the name of the event. 

1 - an object that implements the StreamEventListener Interface. 

Returns: 

The event Identifier. 

Throws: 

UnknownEventException - the event cannot be found at this time 

Insuf f IcientResourcesException - if resources needed to perform the subscription are 
not available 

unsubscribe(int, StreamEventListener) 

public void unsubscribe (int eventid, org . dvb . dsmcc . StreamEventListener 1) 
throws UnknownEventException 

This function is used to cancel the subscription to an event of a DSMCCEvent object. 

Parameters: 

eventid - Identifier of the event. 

1 - an object that implements the StreamEventListener Interface. 

Throws: 

UnknownEventException - The event can not be found. 
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unsubscribe(String, StreamEventListener) 

public void unsubscribe (Java . lang . String eventName, org. dvb . dsmcc . StreamEventListener 1) 
throws UnknownEventException 

This function is used to cancel tine subscription to an event of a DSIVICCEvent object. 

Parameters: 

eventName - tine name of tine event. 

1 - an object tiiat implements the StreamEventListener Interface. 

Throws: 

UnknownEventException - The event can not be found. 
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org.dvb.dsmcc 

lllegalObjectTypeException 

Declaration 

public class lllegalObjectTypeException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . lllegalObjectTypeException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This Exception is thrown when the apphcation attempted to create a DSMCCStream or DSMCCStreamEvent 
object with an object or a path that did not correspond to a DSMCC Stream or DSMCC StreamEvent respectively 



Constructors 

IllegalObj ectTypeExceptionO 

public lllegalObjectTypeException () 

constructor of the exception with no detail message 
IllegalObjectTypeException(String) 

public lllegalObjectTypeException (Java. lang. String s) 

constructor of the exception 

Parameters: 

s - detail message 



ETSI 



572 ETSITS 101 812V1.3.1 (2003-06) 



org.dvb.dsmcc 

InsufficientResourcesEvent 



Declaration 

public class InsufficientResourcesEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util . Even tObj act 
I 
H org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . InsufficientResourcesEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is generated if there are insufficient resources available to load a DSMCCObject. e.g. if there's not 
enough memory. 



Constructors 

InsufflcientResourcesEvent(DSMCCObject) 

public InsufficientResourcesEvent (org . dvb . dsmcc . DSMCCObject o) 

Create an InsufficientResourcesException object. 

Parameters: 

o - the DSMCCObject that generated the event. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that generated the event 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSMCCObject that generated the event 
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org.dvb.dsmcc 

InsufficientResourcesException 

Declaration 

public class InsufficientResourcesException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . InsufficientResourcesException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This exception gets thrown when a request to perform a DSMCC related operation cannot be completed due to 
resource limitations. For example, no section filters or system timers may be available. 

Since: 

MHP 1.0.1 



Constructors 

InsufficientResourcesExceptionO 

public InsufficientResourcesException () 

Construct an InsufficientResourcesException witin no detail message 
InsufficientResourcesException(String) 

public Insuf ficientResourcesException (j ava . lang. String message) 

Construct an InsufficientResourcesException with the specified detail message 

Parameters: 

message - the message for the exception 
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org.dvb.dsmcc 

InvalidAddressException 



Declaration 

public class InvalidAddressException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . InvalidAddressException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

An InvalidAddressException is thrown when the format of an NSAP address is not recognized. 



Constructors 

InvalidAddressExceptionQ 

public InvalidAddressException ( ) 

Construct a InvalidAddressException with no detail message 
InvalidAddressException(String) 

public InvalidAddressException (Java . lang . String s) 

Construct a InvalidAddressException with the specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

InvalidFormatEvent 



Declaration 

public class InvalidFormatEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util . Even tObj act 
I 
-I org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . InvalidFormatEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is generated if the fonnat of the data received is inconsistent. 



Constructors 

InvalidFormatEvent(DSMCCObject) 

public InvalidFormatEvent (org . dvb . dsmcc . DSMCCObject o) 

Create an InvalidFormatException object. 

Parameters: 

o - the DSMCCObject that generated the event. 



Methods 



getSourceO 

public Java. lang. Object getSourceO 

Returns the DSMCCObject that generated the event 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSMCCObject that generated the event 
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org.dvb.dsmcc 

InvalidFormatException 



Declaration 

public class InvalidFormatException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . InvalidFormatException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

An InvalidFormatException is thrown when an inconsistent DSMCC message is received. 



Constructors 

InvalidFormatExceptionO 

public InvalidFormatExceptionO 

Construct an InvalidFormatException with no detail message 
InvalidFormatException(String) 

public InvalidFormatException (j ava . lang. String s) 

Construct an InvalidFormatException with the specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

InvalidPathnameEvent 



Declaration 

public class InvalidPathnameEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
-I org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . InvalidPathnameEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The pathname does not exist or the ServiceDomain has been detached. 



Constructors 



InvalidPathnameEvent(DSMCCObject) 

public InvalidPathnameEvent (org. dvb . dsmcc . DSMCCObject o) 

Create an InvalidPathnameEvent. 

Parameters: 

o - the DSCMCCObject that generated this event. 



Methods 



getSourceO 

public Java. lang. Object getSourceO 

Returns the DSMCCObject that generated the event. 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSMCCObject that generated the event. 
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org.dvb.dsmcc 

InvalidPathNameException 



Declaration 

public class InvalidPathNameException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . InvalidPathNameException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The InvalidPathNameException is thrown when the path name to a DSMCCObject does not exist or if the 
ServiceDomain has been detached. 



Constructors 

InvalidPathNameExceptionQ 

public InvalidPathNameException ( ) 

Construct an InvalidPathNameException with no detail message 
InvalidPathNameException(String) 

public InvalidPathNameException (Java . lang . String s) 

Construct an InvalidPathNameException with the specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

LoadingAbortedEvent 

Declaration 

public class LoadingAbortedEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
-I org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . LoadingAbortedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event will be sent to the AsynchronousEventListener when an asynchronous loading operation is aborted. 

Since: 

MHP 1.0.1 



Constructors 

LoadingAbortedEvent(DSMCCObject) 

public LoadingAbortedEvent (org . dvb . dsmcc . DSMCCObject aDSMCCOb ject ) 

Creates a LoadingAbortedEvent object. 

Parameters: 

aDSMCCOb ject - the DSMCCObject that generated the event. 



Methods 

getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that generated the event. 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSIVICCObject whose loading was aborted 
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org.dvb.dsmcc 

MPEGDeliveryErrorEvent 

Declaration 

public class MPEGDeliveryErrorEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
-I org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . MPEGDeliveryErrorEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

An MPEGDeliveryErrorEvent indicates that an error (for instance, a time out or accessing the data would require 
tuning) has occurred while loading data from an MPEG Stream. 



Constructors 

MPEGDeliveryErrorEvent(DSMCCObject) 

public MPEGDeliveryErrorEvent {org.dvb.dsmcc. DSMCCObject o) 

Creates an MPEGDeliveryEvent. 

Parameters: 

o - the DSMCCObject that generated the event. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that generated the event. 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSMCCObject that generated the event. 
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org.dvb.dsmcc 

MPEGDeliveryException 

Declaration 

public class MPEGDeliveryException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . MPEGDeliveryException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

An MPEGDEliveryException is thrown when an error (for instance, a time out or accessing the data would require 
tuning) occurs while loading data from an MPEG Stream. 



Constructors 

MPEGDeliveryExceptionQ 

public MPEGDeliveryException ( ) 

Construct an MPEGDeliveryException witin no detail message 
MPEGDeliveryException(String) 

public MPEGDeliveryException (Java . lang. String s) 

Construct an MPEGDeliveryException with the specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

NotEntitledEvent 



Declaration 

public class NotEntitledEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
-I org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . NotEntitledEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event is sent when an attempt to asynchronously load an object has failed because the elementary stream 
carrying the object is scrambled and the user is not entitled to access the content of the object. 



Constructors 

NotEntitledEvent(DSMCCObject) 

public NotEntitledEvent (org. dvb. dsmcc. DSMCCObject o) 

Creates a NotEntitledEvent object. 

Parameters: 

o - the DSMCCObject that generated the event. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that generated the event. 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSMCCObject that generated the event. 
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org.dvb.dsmcc 

NotEntitledException 

Declaration 

public class NotEntitledException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . NotEntitledException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This Exception is thrown when the user is not entitled to access the content of the object (the Elementary Stream is 
scrambled and the user is not entitled). 



Constructors 

NotEntitledExceptionQ 

public NotEntitledException ( ) 

construct a NotEntitledException witin no detail message 
NotEntitledException(String) 

public NotEntitledException (Java . lang . String s) 

construct a NotEntitledException with a detail message 

Parameters: 

s - detail message 
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org.dvb.dsmcc 

NothingToAbortException 



Declaration 

public class NothingToAbortException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . NothingToAbortException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

A NothingToAbortException is thrown when the abort method is called and there is no loading in progress. 



Constructors 

NothingToAbortExceptionQ 

public NothingToAbortException ( ) 

Construct a NothingToAbortException witin no detail message 
NothingToAbortException(String) 

public NothingToAbortException (Java . lang . String s) 

Construct a NotiningToAbortException witin tine specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

NotLoaded Exception 

Declaration 

public class NotLoadedException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . NotLoadedException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

A NotLoadedException is thrown when the Stream object constructor is called with a DSMCC Object which is not 
loaded. 



Constructors 

NotLoadedExceptionO 

public NotLoadedExceptionO 

Construct a NotLoadedException with no detail message 
NotLoadedException(String) 

public NotLoadedException (j ava . lang. String s) 

Construct a NotLoadedException witin tine specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

NPTDiscontinuityEvent 

Declaration 

public class NPTDiscontinuityEvent extends NPTStatusEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . dsmcc . NPTStatusEvent 

+ — org . dvb . dsmcc . NPTDiscontinuityEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Sent when an MHP terminal detects a permanent discontinuity in NPT as defined in the main body of this 
specification. This represents an error condition in the incoming broadcast. 

This event shall be sent following a PCR discontinuity when the MHP terminal has enough information to 
determine that there will be an NPT discontinuity. If the NPTDiscontinuityEvent is because of invalid data 
in a new NPTReferenceDescriptor then the event will be generated when that new NPTReferenceDescriptor is 
detected by the MHP terminal. If the NPTDiscontinuityEvent is because no new NPTReferenceDescriptor 
is detected within the time allowed by the main body of this specification then it will be generated when that time 
interval has elapsed. 

Since: 

MHP 1.0.1 



Constructors 



NPTDiscontinuityEvent(DSMCCStream, long, long) 

public NPTDiscontinuityEvent (org . dvb . dsmcc . DSMCCStream source, long before, long after) 

Construct an event. The before and after values used shall be the values at the time when the 
receiver determined that a NPT discontinuity has happened. If the NPTDiscontinuityEvent is 
because of invalid data in a new NPTReferenceDescriptor then this is the time when that new 
descriptor was known to be invalid. If NPTDiscontinuityEvent is because of the absence of a 
new NPTReferenceDescriptor then this will be when the MHP terminal detects that the time interval 
allowed by this specification for such new descriptors has elapsed. Where an NPT value is unknown 
or cannot be computed, -1 shall be used. 

Parameters: 

source - the stream whose NPT suffered a discontinuity 

before - the last NPT value detected before the discontinuity 
after - the first NPT value detected after the discontinuity 
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Methods 



getFirstNPTO 

public long getFirstNPTO 

Return the first known stable value of NPT after the discontinuity 



Returns: 

an NPT value 



getLastNPTO 

public long getLastNPTO 

Return the last known stable value of NPT before the discontinuity 



Returns: 

an NPT value 
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org.dvb.dsmcc 

NPTListener 



Declaration 

public interface NPTListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

Objects that implement the NPTListener interface can receive NPTStatusEvent and 

NPTRateChangedEvent events. 

Since: 

MHP 1.0.1 



Methods 



receiveNPTStatusEvent(NPTStatusEvent) 

public void receiveNPTStatusEvent (org . dvb . dsmcc .NPTStatusEvent e) 

Send a NPTStatusEvent to a registered listener. 

Parameters: 

e - a NPTStatusEvent describing tiie status ciiange 

receiveRateChangedEvent(NPTRateChangeEvent) 

public void receiveRateChangedEvent (org . dvb . dsmcc .NPTRateChangeEvent e) 

Send a NPTRateChangeEvent to a registered listener. 

Parameters: 

e - the NPTRateChangeEvent event. 
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org.dvb.dsmcc 

NPTPresentEvent 



Declaration 

public class NPTPresentEvent extends NPTStatusEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . dsmcc . NPTStatusEvent 

+ — org . dvb . dsmcc . NPTPresentEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Sent to listeners on a DSMCCStream object when NPT newly appears for that DSMCC stream when it was not 
previously present. This is specific to the particular timebase for this stream. 

Since: 

MHP 1.0.1 



Constructors 



NPTPresentEvent(DSMCCStream) 

public NPTPresentEvent (org . dvb . dsmcc . DSMCCStream source) 

Construct an event. 

Parameters: 

source - the DSMCCStream for which the NPT event appeared. 
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org.dvb.dsmcc 

NPTRate 



Declaration 

public class NPTRate 
Java . lang .Object 

+ — org . dvb . dsmcc . NPTRate 

Description 

Represents the rate at which an NPT time-base progresses. Rates are expressed as the combination of a numerator 
and a denominator. Instances of this class are constructed by the platform and returned to applications. A rate of 1/ 
1 shall indicate "the standard presentation rate" as defined in the NPT specification. 

Since: 

MHP 1.0.1 



Methods 

getDenominatorQ 

public int getDenominator ( ) 

Get the NPT rate's denominator. 

Returns: 

the denominator 

getNumeratorQ 

public int getNumerator ( ) 

Get the NPT rate's numerator. A value of zero indicates that the NPT is not progressing. 

Returns: 

the numerator 
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org.dvb.dsmcc 

NPTRateChangeEvent 



Declaration 

public class NPTRateChangeEvent extends Java .util . EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+--org . dvb . dsmcc . NPTRateChangeEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Description 

Sent only when the rate of an NPT time-base changes value. 

Since: 

MHP 1.0.1 



Constructors 



NPTRateChangeEvent(DSMCCStream,NPTRate) 

public NPTRateChangeEvent (org . dvb . dsmcc . DSMCCStream source, org. dvb . dsmcc .NPTRate rate) 

Construct an event. 

Parameters: 

source - the stream whose rate changed 

rate - the new rate of that stream immediately following the change 



Methods 



getRateO 

public org . dvb . dsmcc .NPTRate getRateO 

Return the new rate of the stream immediately after the change. 

Returns: 

a NPTRate object encapsulating the new rate 

getSourceO 

public Java. lang. Object getSource ( ) 

Return the stream whose rate changed. 

Overrides: 

getSource in class EventObject 

Returns: 

the DSMCCStream object on which the rate change has occurred. 
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org.dvb.dsmcc 

N PTRemoved Event 



Declaration 

public class NPTRemovedEvent extends NPTStatusEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . dsmcc . NPTStatusEvent 

+ — org . dvb . dsmcc . NPTRemovedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Sent to listeners on a DSMCCStream object when NPT which was present for that DSMCC stream is removed. 
This is specific to the particular timebase for this stream. 

Since: 

MHP 1.0.1 



Constructors 



NPTRemovedEvent(DSMCCStream) 

public NPTRemovedEvent (org . dvb . dsmcc . DSMCCStream source) 

Construct an event. 

Parameters: 

source - the DSMCCStream from which the NPT was removed 
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org.dvb.dsmcc 

NPTStatusEvent 



Declaration 

public abstract class NPTStatusEvent extends j ava . util . EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+- -org.dvb.dsmcc .NPTStatusEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Direct Known Subclasses: 

NPTDiscontinuityEvent, NPTPresentEvent, NPTRemovedEvent 

Description 

Sent when an MHP terminal detects a change of status in the NPT of a stream. 

Since: 

MHP 1.0.1 



Constructors 



NPTStatusEvent(DSMCCStream) 

public NPTStatusEvent (org.dvb.dsmcc. DSMCCStream source) 

Construct an event. 

Parameters: 

source - the stream whose NPT status changed 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Return the stream whose NPT status changed. 

Overrides: 

getSource in class EventObject 

Returns: 

the DSMCCStream whose status changed 
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org.dvb.dsmcc 

ObjectChangeEvent 

Declaration 

public class ObjectChangeEvent extends Java . util .EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+--org . dvb . dsmcc . ObjectChangeEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Description 

This class describes an object change event that is used to monitor the arrival of a new version of a 

DSMCCOb j ect. For files carried in a DSMCC object carousel, when a change in a module is detected, this event 

shall be sent to all registered listeners for all objects carried in that module. 



Constructors 

ObjectChangeEvent(DSMCCObject,int) 

public ObjectChangeEvent (org . dvb . dsmcc . DSMCCObj ect source, int aVersionNumber ) 

Creates an ObjectChangeEvent indicating tinat a new version of tine monitored DSIVICC Object inas 
been detected. It is up to tine application to reload the new version of the object. 

Parameters: 

source - the DSMCCObject whose version has changed 

aVersionNumber - the new version number. 



Methods 

getNewVersionNumberQ 

public int getNewVersionNumber ( ) 

This method is used to get the new version number of the monitored DSMCCObj ect. For files carried 
in a DSMCC object carousel, this method shall return the version number of the module carrying the 
file. 

Returns: 

the new version number. 
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getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that has changed 

Overrides: 

getSource in class EventObject 

Returns: 

the DSMCCObject that has changed 
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org.dvb.dsmcc 

ObjectChangeEventListener 

Declaration 

public interface ObjectChangeEventListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

The objects that implements the ObjectChangeEventListener interface can receive ObjectChangeEvent event. 



Methods 

receiveObj ectChangeEvent(Obj ectChangeEvent) 

public void receiveObjectChangeEvent (org . dvb . dsmcc .ObjectChangeEvent e) 

Send a ObjectChangeEvent to the ObjectChangeEventListener. 

Parameters: 

e - the ObjectChangeEvent event. 
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org.dvb.dsmcc 

ServerDeliveryErrorEvent 

Declaration 

public class ServerDeliveryErrorEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
-I org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . ServerDeliveryErrorEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The local machine can not communicate with the server. This event is only used with files implemented by 
delivery over bi-directional IP connections. For the object carousel the MPEGDeliveryErrorEvent is used 
instead. 



Constructors 

ServerDeliveryErrorEvent(DSMCCObject) 

public ServerDeliveryErrorEvent (org. dvb . dsmcc . DSMCCObject o) 

Creates a ServerDeliveryEvent object. 

Parameters: 

o - the DSMCCObject that generated the event. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that generated the event. 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSMCCObject that generated the event. 
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org.dvb.dsmcc 

ServerDeliveryException 

Declaration 

public class ServerDeliveryException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . ServerDeliveryException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

A ServerDeliveryException is thrown when the local machine can not communicate with the server. This exception 
is only used with files implemented by delivery over a bi-directional IP connection. For the object carousel the 
MPEGDeliveryException is used instead. 



Constructors 

ServerDeliveryExceptionQ 

public ServerDeliveryException ( ) 

Construct a ServerDeliveryException with no detail message 
ServerDeliveryException(String) 

public ServerDeliveryException (Java . lang . String s) 

Construct a ServerDeliveryException with the specified detail message 

Parameters: 

s - the detail message 
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org.dvb.dsmcc 

ServiceDomain 



Declaration 

public class ServiceDomain 
Java . lang .Object 

+ — org . dvb . dsmcc . ServiceDomain 

Description 

A ServiceDomain represents a group of DSMCC objects. The objects are sent either using the object carousel 
for a broadcast network or with the DSM-CC User-to-User protocol for an interactive network. 

To access the objects of a ServiceDomain, it has to be attached to the file system name space of the MHP 
terminal. To access the content of an object, the application has four ways: 

• It can instantiate the class that is used to read the object (java.io.FilelnputStream or java.io.RandomAccessFile 
for a File or DSMCCStream for a stream) from its pathname. The loading of the object is implicit but the appli- 
cation has no way to abort it. NB: Obviously, for the Object Carousel, the write mode of java.io.Random- 
AccessFile is not allowed. 

• It can instantiate a DSMCCObject and carry out a Synchronous loading. The loading can be aborted by the 
abort method of the DSMCCObject class. When the object is loaded, the application will instantiate the class 
used to read the object. 

• It can instantiate a DSMCCObject and carry out an Asynchronous loading. So several loading can be started in 
parallel from the same thread. 

• It is also possible to create directly a java.io.File for a DSMCC object. 

Instances of ServiceDomain exist in two states, attached and detached. Newly created instances are always in 
the detached state. They become attached when a call to the attach method succeeds. They become detached 
following a call to the detach method. 

When service domains in the attached state temporarily lose their network connection, (e.g. if the MHP terminal 
tunes away from the transport stream where they are carried), the behaviour of DSMCC objects which are part of 
the service domain is specified in the main body of this specification. If such a network connection becomes 
available again then the service domain shall resume normal behaviour. 

A service domain which is temporarily lost its network connection may be forced into the detached state by the 
implementation if the loss of the network connection becomes irrecoverable. The precise details of when this 
happens are implementation dependent. This is the only situation when shall be forced into the detached state. 
Once a ServiceDomain is detached, it will never be automatically attached. 



Constructors 

ServiceDomainO 

public ServiceDomainO 

Creates a ServiceDomain object. 
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Methods 



attach(byte[l) 

public void attach (byte [ ] NSAP Address) 

throws DSMCCException, InterruptedlOException, InvalidAddressException, MPEGDe 
livery Except ion 

This function is used to attacin a ServiceDomain from eitiner an object carousel or from an 
interactive networl<. Tinis call will block until the attachment is done. 

Calling this method on a ServiceDomain object already in the attached state shall imply a detach 
of the ServiceDomain object before the attach operation unless the ServiceDomain is already 
attached to the correct location. Hence if the attach operation fails, the appropriate exception for the 
failure mode shall be thrown and the ServiceDomain is left in a detached state and not attached to 
the former object carousel / service domain. If the ServiceDomain is already attached to the 
correct location then the method call shall have no effect. 

Parameters: 

NSAPAddress - The NSAP Address of a ServiceDomain as defined in in ISO/IEC 13818-6 

Throws: 

j ava . io . InterruptedlOException - The attachment has been aborted. 

InvalidAddressException - The NSAP Address is invalid. 
DSMCCException - An error has occurred during the attachment. 
MPEGDeliveryException - attaching to this domain would require tuning. 



attach(Locator) 

public void attach (org . davic . net . Locator 1) 

throws DSMCCException, InterruptedlOException, MPEGDeliveryException 

This function is used to attach a ServiceDomain from an object carousel. It loads the module 
which contains the service gateway object and mounts the ServiceDomain volume in the file 
system hierarchy. This call will block until the service gateway is loaded. It can be aborted by another 
thread with the method detach. In this case an InterruptedlOException is thrown. 

Calling this method on a ServiceDomain object already in the attached state shall imply a detach 
of the ServiceDomain object before the attach operation unless the ServiceDomain is already 
attached to the correct location. Hence if the attach operation fails, the appropriate exception for the 
failure mode shall be thrown and the ServiceDomain is left in a detached state and not attached to 
the former object carousel / service domain. If the ServiceDomain is already attached to the 
correct location then the method call shall have no effect. 

Parameters: 

1 - The locator pointing to the elementary stream carrying the DSI of the object carousel, or to a 
DVB service that carries one and only one object carousel. 

Throws: 

DSMCCException - An error has occurred during the attachment. For example, the locator does 
not point to a component carrying a DSI of an Object Carousel or to a service containing a single 
carousel 

j ava . io . InterruptedlOException - The attachment has been aborted. 

MPEGDeliveryException - attaching to this domain would require tuning. 
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attach(Locator, int) 

public void attach (org . davic . net . Locator aDVBService, int aCarouselld) 

throws ServiceXFRException, InterruptedlOException, MPEGDeliveryException 

This function is used to attacin a ServiceDomain from an object carousel. It loads the module which 
contains the service gateway object and mounts the ServiceDomain volume in the file system 
hierarchy. This call will block until the service gateway is loaded. It can be aborted by another thread 
with the method detach. In this case an InterruptedlOException is thrown. 

Calling this method on a ServiceDomain object already in the attached state shall imply a detach 
of the ServiceDomain object before the attach operation unless the ServiceDomain is already 
attached to the correct location. Hence if the attach operation fails, the appropriate exception for the 
failure mode shall be thrown and the ServiceDomain is left in a detached state and not attached to 
the former object carousel / service domain. If the ServiceDomain is already attached to the 
correct location then the method call shall have no effect. 

Parameters: 

aDVBService - The coordinates of the DVB service which contains the object carousel. This 
locator has to point to a DVB service. 

aCarouselld -The identifier of the carousel. 

Throws: 

j ava . io . InterruptedlOException - The attachment has been aborted. 

MPEGDeliveryException - An MPEG error occurred (such as time-out). 

ServiceXFRException -The service gateway cannot be loaded in the current service domain. 
This exception shall not be thrown in this version of the specification. 



detachO 

public void detach ( ) 

throws NotLoadedException 

A call to this method is a hint that the applications gives to the MHP to unmount the volume and 
delete the objects of the service domain. When another application is using objects of the same 
service domain the method has no effects. When there are no other application using objects of the 
service domain, a call to this method is a hint that the MHP can free all the resources allocated to 
this service domain. 

After this, the ServiceDomain will be in a non-attached state and will behave as if it had just been 
constructed. Subsequent calls to detach shall throw NotLoadedException. 

Throws: 

NotLoadedException - is thrown if the ServiceDomain is not attached or if there is no call to 
attach in progress. 



getLocatorO 

public org. davic. net . Locator getLocatorO 

Return the locator for this service domain. If this ServiceDomain instance was last attached by 
specifying a locator then an equivalent locator shall be returned except if the original locator 
contained extra information that is not necessary to identify the service domain in which case this 
extra information is removed. If the attach was done with the attach (locator, int) signature, 
the locator is complemented with the component_tag value that the platform has identified during 
attaching the ServiceDomain. If this ServiceDomain instance was last attached by specifying an 
NSAP address then the locator shall be generated from that address. If this ServiceDomain has 
never been attached then null shall be returned. 
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The syntax of the NSAP address is defined in section titled "LiteOptionsProfileBody" in annex B of 
the IVIHP specification. It contains the same fields as the locator syntax specified in the System 
integration aspects chapter. The locator is constructed by taking the fields out of the NSAP address 
and encoding them in the locator syntax together with the component_tag value that the platform has 
identified during attaching the ServiceDomain. 

Returns: 

a locator for this service domain 

Since: 

MHP 1.0.1 



getMountPointO 

public org.dvb.dsmcc. DSMCCObject getMountPointO 

Returns a DSMCCObject object describing the top level directory of this ServiceDomain. If the 
ServiceDomain object is not attached then null is returned. 

Returns: 

an instance of org.dvb.dsmcc. DSMCCObject if attached or null otherwise 

Since: 

MHP 1.0.1 

getNSAPAddressO 

public byte [ ] getNSAPAddress ( ) 

throws NotLoadedException 

This method returns the NSAP address of the ServiceDomain. 

Returns: 

the NSAP address of the ServiceDomain. 

Throws: 

NotLoadedException - is thrown if the ServiceDomain is not attached. 



getURL(Locator) 

public static Java. net. URL getURL (org . davic . net . Locator 1) 

throws NotLoadedException, InvalidLocatorException, FileNotFoundException 

Obtain a java.net.URL corresponding to a 'dvb:' locator. If the service domain corresponding to the 
locator is attached and the file referenced in the locator exists then an instance of j ava . net . URL is 
returned which can be used to reference this file. 

Parameters: 

1 - a locator object encapsulating a 'dvb:' locator which includes a 'dvb_abs_path' element. 

Returns: 

a j ava . net . URL which can be used to access the file referenced by the 'dvb:' locator 

Throws: 

org . davic . net . InvalidLocatorException - if the locator is not a valid 'dvb:' locator or 
does not includes all elements including 'dvb_abs_path' element 

NotLoadedException - is thrown if the locator is valid and includes enough information but it 
references a service domain which is not attached. 

j ava . io . FileNotFoundException - if the service domain is attached but the file referenced 
by the locator does not exist 
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isAttachedO 

public boolean isAttachedO 

Return whether this service domain is in the attached or detached state. 

Returns: 

true if this service domain is in the attached state, otherwise false 

Since: 

IVIHP 1.0.1 



isNetworkConnectionAvailableO 

public boolean isNetworkConnectionAvailable ( ) 

Return whether the networl< connection for this service domain is available. This return value is 
independent of whether the service domain is attached or not. If a service domain is distributed 
across multiple network connections (e.g. using the optional support for DSMCC over NOP) then this 
will reflect the availability of the network connection carrying the object mounted to the mount point. 

Returns: 

true if the network connection for this service domain is available otherwise false 

Since: 

MHP 1.0.1 
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org.dvb.dsmcc 

ServiceXFRErrorEvent 



Declaration 

public class ServiceXFRErrorEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
H org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org . dvb . dsmcc . ServiceXFRErrorEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The object requested is available in an alternate ServiceDomain. When an application attempts to asynchronously 
load an object that has itself a LiteOptionProfileBody lOR or that has a parent directory that has a 
LiteOptionProfileBody lOR, this event shall be sent to the application. There is no implicit mounting by the 
implementation of the carousel that actually contains the object. This event is also sent even if the Service Domain 
that actually contains the DSMCCObject is already mounted. 



Constructors 



ServiceXFRErrorEvent(DSMCCObject, ServlceXFRReference) 

public ServiceXFRErrorEvent (org.dvb.dsmcc. DSMCCObject o, 
org . dvb . dsmcc . ServlceXFRReference ref ) 

Creates a ServiceXFRErrorEvent object. 

Parameters: 

o - the DSMCCObject that generated the event. 

ref - the address of an alternate ServiceDomain where the object can be found. 



Methods 

getServiceXFRO 

public org . dvb . dsmcc . ServlceXFRReference getServiceXFR ( ) 

This method is used to get a reference to the service domain that contains the requested object. 

Returns: 

The address of an alternate ServiceDomain where the object can be found. 



ETSI 



605 



ETSITS 101 812V1.3.1 (2003-06) 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObject that generated the event. 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the DSMCCObject that generated the event. 
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org.dvb.dsmcc 

ServiceXFRException 

Declaration 

public class ServiceXFRException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . ServiceXFRException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

A ServiceXFRException is thrown when a DSMCC Object can not be loaded in the current ServiceDomain but is 
available in an alternate ServiceDomain (i.e. for an object Carousel, the lOR of the object or one of its parent 
directories contains a Lite Option Profile Body). There is no implicit mounting by the implementation of the 
carousel that actually contain the object. This exception is also thrown even if the Service Domain that actually 
contains the DSMCCObject is already mounted. 



Constructors 



ServiceXFRException(byte [] , String) 

public ServiceXFRException (byte [ ] NSAPAddress, Java . lang . String pathName) 

Creates a ServiceXFRException object. 

Parameters: 

NSAPAddress - Tiie NSAP Address of a ServiceDomain as defined in ISO/IEC 13818-6 

pathName - patiiName of the object in tiie alternate ServiceDomain 



ServiceXFRException(Locator, int, String) 

public ServiceXFRException (org . davic . net . Locator aService, int carouselld, 
j ava . lang. String pathName) 

Creates a ServiceXFRException object. 

Parameters: 

aService - Locator of tine Service 

carouselld - Carousel Identifier 

pathName - pathName of the object in the alternate ServiceDomain 
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Methods 



getServiceXFRO 

public org . dvb . dsmcc . ServiceXFRRef erence getServiceXFR ( ) 

This method is used to get the alternate ServiceDomain which contains the object requested. 

Returns: 

the address of an alternate ServiceDomain where the object can be found. 
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org.dvb.dsmcc 

ServiceXFRReference 



Declaration 

public class ServiceXFRReference 
Java . lang .Object 

+ — org . dvb . dsmcc . ServiceXFRReference 

Description 

A ServiceXFRReference object is used when a DSMCC Object can not be loaded in the current ServiceDomain but 
is available in an alternate ServiceDomain. Instances of this class are just containers. The parameters passed are 
merely stored and returned by the access methods. It is the responsibility of the platform when generating instances 
to use correct values. 



Constructors 

ServiceXFRReference(byte[l, String) 

public ServiceXFRReference (byte [ ] nsapAddress, j ava . lang. String pathName) 

Creates a ServiceXFRReference object. 

Parameters: 

nsapAddress -The NSAP Address of a ServiceDomain as defined in ISO/IEC 13818-6 

pathName - patinName of tine object in tine alternate ServiceDomain 



ServiceXFRReference(Locator, int, String) 

public ServiceXFRReference (org . davic . net . Locator serviceLocator, int carouselld, 
j ava . lang . String pathName) 

Creates a ServiceXFRReference object. 

Parameters: 

serviceLocator - Locator of tine Service 

carouselld - Carousel Identifier 

pathName - pathName of the object in the alternate ServiceDomain 



Methods 



getCarouselldO 

public int getCarouselldO 

This method returns the carousel identifier. If the object was constructed using the constructor which 
includes a carousel ID or if it was constructed using the constructor which includes an NSAP 
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address and that NSAP address contains a carousellD then this method shall return that carousel ID 
otherwise this method shall return -1. 

Returns: 

the carousel identifier or -1 . 



getLocatorO 

public org . davic . net . Locator getLocator ( ) 

This method returns the Locator of the Service for an Object Carousel. 

Returns: 

the Locator of the Service for an Object Carousel. This method returns null, if the ServiceDomain 
is not associated with an Object Carousel. In this case the NSAP address must be used instead. 

getNSAPAddressO 

public byte [ ] getNSAPAddress ( ) 

This method returns the NSAP Address of a ServiceDomain as defined in ISO/IEC 13818-6. If the 
object was constructed using an NSAP address then this method shall return the NSAP address 
passed into the constructor. If the object was constructed with a locator and a carousellD then this 
method shall return an NSAP address derived from this information when locator is an instance of 
org. davic. net.dvb.DVBLocator. Otherwise this method shall return null 

Returns: 

the NSAP Address of a ServiceDomain as defined in ISO/IEC 13818-6 or null 



getPathNameO 

public Java. lang. String getPathNameO 

This method returns the pathname of the object in the alternate ServiceDomain. 

Returns: 

the pathname of the object in the alternate ServiceDomain. 
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org.dvb.dsmcc 

Stream Event 



Declaration 

public class StreamEvent extends j ava . util . EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+--org . dvb . dsmcc . StreamEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Description 

This class describes a Stream event which is used to synchronize an apphcation with an MPEG Stream. 



Constructors 



StreamEvent(DSMCCStreamEvent, long, String, int, byteU) 

public StreamEvent (org . dvb . dsmcc . DSMCCStreamEvent source, long npt, j ava . lang. String name, 
int eventid, byte[] eventData) 

Creates a StreamEvent object. 

Parameters: 

source -The DSMCCStreamEvent that has generated the event. 

npt - The value of the NPT (Normal Play Time) when the event is triggered. This value is equal 
to the field eventNPT in the DSMCC StreamEventDescriptor except where the event is a "do it 
now" event in which case the value -1 is returned (as the value of NPT may not be meaningful). 

name - The name of this event. The list of event names is located in the DSMCC StreamEvent 
object. This list is returned by the method DSMCCStreamEvent . getEventList. 

eventid - The eventid of this event. The list of event IDs is located in the DSMCC StreamEvent 
object. 

eventData -The application specific data found in the DSMCC StreamEventDescriptor. 



Methods 

getEventDataO 

public bYte[] getEventDataO 

This method is used to retrieve the private data associated with the event. 

Returns: 

The private data associated with the event. 
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getEventldO 

public int getEventldO 

This method is used to get the identifier of the StreamEvent. 

Returns: 

The identifier of the StreamEvent. 



getEventNameO 

public j ava . lang. String getEventNameO 

This method is used to get the name of the StreamEvent 

Returns: 

the name of the StreamEvent 



getEventNPTQ 

public long getEventNPT () 

This method is used to get the NPT of the Event in milliseconds. 



Returns: 

The NPT of the Event in milliseconds. 



getSourceO 

public Java. lang. Object getSource ( ) 

This method returns the DSMCCStreamEvent that generated the event. 

Overrides: 

getSource in class EventObject 



Returns: 

the DSMCCStreamEvent that generated the event. 
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org.dvb.dsmcc 

StreamEventListener 



Declaration 

public interface StreamEventListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

Objects that implement the StreamEventListener interface can receive StreamEvent event. 



Methods 

receiveStreamEvent(StreamEvent) 

public void receiveStreamEvent (org . dvb . dsmcc . StreamEvent e) 

Send a StreamEvent to the StreamEventListener. 

Parameters: 

e - the StreamEvent event. 
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org.dvb.dsmcc 

SuccessEvent 



Declaration 

public class SuccessEvent extends AsynchronousLoadingEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
-I org . dvb . dsmcc . AsynchronousLoadingEvent 

+ — org.dvb.dsmcc. SuccessEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event indicates that the asynchronous loading was successful. 



Constructors 



SuccessEvent(DSMCCObj ect) 

public SuccessEvent (org. dvb. dsmcc .DSMCCObj ect o) 
Creates a SuccessEvent object. 

Parameters: 

o - the DSMCCObj ect which was successfully loaded. 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the DSMCCObj ect which was successfully loaded. 

Overrides: 

getSource in class AsynchronousLoadingEvent 

Returns: 

the loaded DSMCCObject 



ETSI 



614 ETSITS 101 812V1.3.1 (2003-06) 

org.dvb.dsmcc 

UnknownEventException 

Declaration 

public class UnknownEventException extends DSMCCException 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

H j ava . io . lOException 

I 

+--org . dvb . dsmcc . DSMCCException 

+ — org . dvb . dsmcc . UnknownEventException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The UnknownEventException is thrown when a method tries to access to an unknown event. This exception 
may get thrown because the event in question is not being signalled yet. It does not indicate that the event is 
permanently unavailable. Applications may choose to attempt to subscribe to the event again at a later point in time 
in the expectation that the event has become available since the previous attempt. 



Constructors 

UnknownEventExceptionO 

public UnknownEventExceptionO 

Construct an UnknownEventException with no detail message 
UnknownEventException(String) 

public UnknownEventException (j ava . lang . String s) 

Construct an Unl<nownEventException witin tine specified detail message 

Parameters: 

s - the detail message 
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Annex Q (normative): Datagram Socket Buffer Control 
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Package 

org.dvb.net 



Description 

Provides general networking features not found elsewhere. 



Class Summary 



Classes 

DatagramSocketBuf f er- Jhjs class provides additional control over buffering for DatagramSocketS. 
Control 
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org.dvb.net 

DatagramSocketBufferControl 



Declaration 

public class DatagramSocketBufferControl 
Java . lang .Object 

+ — org.dvb .net .DatagramSocketBufferControl 

Description 

This class provides additional control over buffering for DatagramSockets. 



Methods 



getReceiveBufferSize(DatagramSocket) 

public static int getReceiveBufferSize (Java .net . DatagramSocket d) 
throws SocketException 

Get value of the SO_RCVBUF option for this socl<et, that is the buffer size used by the platform for 
input on the this Socket. The value returned need not be the value previously set by 
setReceiveBufferSize (if any). 

Parameters: 

d - The DatagramSocket for which to query the receive buffer size. 

Returns: 

The size of the receive buffer, in bytes. 

Throws: 

j ava . net . SocketException - - If there is an error when querying the SO_RCVBUF option. 



setReceiveBufferSize(DatagramSocket, int) 

public static void setReceiveBufferSize (Java . net . DatagramSocket d, int size) 
throws SocketException 

Sets the SO_RCVBUF option to the specified value for this DatagramSocket. The SO_RCVBUF 
option is used by the platform's networking code as a hint for the size to use when allocating the 
underlying network I/O buffers. 

Increasing buffer size can increase the performance of network I/O for high-volume connection, while 
decreasing it can help reduce the backlog of incoming data. For UDP, this sets the buffer size for 
received packets. 

Because SO_RCVBUF is a hint, applications that want to verify what size the buffers were set to 
should call getReceiveBufferSize. This method shall throw lllegalArgumentException - if size is or 
is negative. 

Parameters: 

d - The DatagramSocket for which to change the receive buffer size. 

size - The requested size of the receive buffer, in bytes. 

Throws: 

j ava . net . SocketException - - If there is an error when setting the SO_RCVBUF option. 
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Annex R (normative): DVB-J Return Channel 
Connection Management API 
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Package 

org.dvb.net.rc 



Description 

Provides session management for bi-directional IP connections which are session based from the point of view of 
an apphcation. The best example of this is a conventional modem. 



Class Summary 



Interfaces 

Connect ionListener 

Classes 

ConnectionEstablishe- 
dEvent 

Connect ionFailedEvent 

Connect ionParameters 

Connect ionRCEvent 

Connect ionRC Inter face 

ConnectionTerminat- 
edEvent 

RCInterf ace 

RCInterf aceManager 

RCInterf aceReleasedE- 
vent 

RCInterf aceReservedE- 
vent 

RCPermission 

Exceptions 

IncompleteTargetEx- 
ception 

PermissionDeniedEx- 
ception 



This interface should be implemented by objects wishing to be notified about 
the connection status of a ConnectionRClnterf ace. 



ConnectionEstablishedEvent - An event generated after a connection is estab- 
lished for a ConnectionRClnterf ace. 

ConnectionFailedEvent - An event generated after an attempt to setup a con- 
nection for a ConnectionRClnterf ace fails. 

This class encapsulates the parameters needed to specify the target of a con- 
nection. 

ConnectionRCEvent - the base class for events related to connection oriented 
return channels. 

This class models a connection based return channel network interface for use 
in receiving and transmitting IP packets over a return channel. 

ConnectionTerminatedEvent - An event generated after a connected 
ConnectionRClnterf ace iS disconnected. 

This class models a return channel network interface for use in receiving and 
transmitting IP packets over a logical return channel. 

This class is the factory and manager for all return channel interfaces in the 
system. 

This event informs an application that a RCInterf ace has been released by 
an application or other entity in the system. 

This event informs an application that a RCInterf ace has been reserved by 
an application or other entity in the system. 

This class is for return channel set-up permissions. 



Thrown when the target for a connection is incompletely specified. 

Thrown when an application calls a method which it does not have permission 
to call at that time. 



ETSI 



620 ETSITS 101 812V1.3.1 (2003-06) 



org.dvb.net.rc 

ConnectionEstablishedEvent 



Declaration 

public class ConnectionEstablishedEvent extends ConnectionRCEvent 

Java . lang .Object 

+ — java.util . Even tObj act 
I 
+--org . dvb . net . re . ConnectionRCEvent 

+ — org. dvb .net . re. ConnectionEstablishedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

ConnectionEstablishedEvent - An event generated after a connection is established for a 

ConnectionRC Inter face. 



Constructors 



ConnectionEstablishedEvent(Object) 

public ConnectionEstablishedEvent (Java. lang. Object source) 

Construct an event. 

Parameters: 

source - the ConnectionRCinterf ace whose connection was established 
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org.dvb.net.rc 

ConnectionFailedEvent 



Declaration 

public class ConnectionFailedEvent extends ConnectionRCEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . net . re . ConnectionRCEvent 

+ — org. dvb .net . re. ConnectionFailedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

ConnectionFailedEvent - An event generated after an attempt to setup a connection for a 

ConnectionRCInterf ace fails. 



Constructors 



ConnectionFailedEvent(Obj ect) 

public ConnectionFailedEvent (Java. lang. Object source) 

Construct an event. 

Parameters: 

source - the ConnectionRCInterf ace whose connection attempt failed 
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org.dvb.net.rc 

ConnectionListener 



Declaration 

public interface ConnectionListener extends Java .util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

This interface should be implemented by objects wishing to be notified about the connection status of a 

Connect ionRC Inter face. 



Methods 



connectionChanged(ConnectionRCEvent) 

public void connectionChanged (org . dvb . net . re . ConnectionRCEvent e) 

This method is called to report events related to the setup and termination of return channel interface 
connections. 

Parameters: 

e - the event which happened 
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org.dvb.net.rc 

ConnectionParameters 



Declaration 

public class ConnectionParameters 
Java . lang .Object 

+ — org . dvb . net . re . ConnectionParameters 

Description 

This class encapsulates the parameters needed to specify the target of a connection. 



Constructors 



ConnectionParameters(String, String, String) 

public ConnectionParameters (Java . lang . String number, j ava . lang . String username, 
j ava . lang . String password) 

Construct a set of connection parameters. Details of the DNS server to use are supplied by the 
server. 

Parameters: 

number - the target of the connection, e.g. a phone number 

username - the username to use in connection setup 
password - the password to use in connection setup 



ConnectionParameters(String, String, String, InetAddressU) 

public ConnectionParameters (Java . lang . String number, j ava . lang . String username, 
j ava . lang . String password, j ava . net . InetAddress[ ] dns) 

Construct a set of connection parameters. 

Parameters: 

number - the target of the connection, e.g. a phone number 

username - the username to use in connection setup 

password - the password to use in connection setup 

dns - the list of DNS servers to try before reporting failure. The order in which they are 
interrogated is not specified. Once one result has been obtained, there is no requirement to try 
others. 



ETSI 



624 ETSITS 101 812V1.3.1 (2003-06) 



Methods 



getDNSServerO 

public Java . net . InetAddress[ ] getDNSServerO 

Return the addresses of the DNS servers to use for the connection 

Returns: 

return the addresses of the DNS servers passed into the constructor of the instance or null if 
none was provided. 

getPasswordO 

public Java. lang. String getPasswordO 

Return the password used in establishing this connection The value returned shall be the one 



passed into the constructor of this instance. 

Returns: 

the password used in establishing this connection 



getTargetO 

public Java. lang. String getTargetO 

Return the target of this connection for example a phone number. The value returned shall be the 



one passed into the constructor of this instance. 

Returns: 

the target of the connection 



getUsernameO 

public j ava . lang. String getUsername ( ) 

Return the username used in establishing this connection The value returned shall be the one 
passed into the constructor of this instance. 

Returns: 

the username used in establishing the connection 
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org.dvb.net.rc 

ConnectionRCEvent 



Declaration 

public class ConnectionRCEvent extends Java . util .EventObject 

Java . lang .Object 

+ — Java. util .EventObject 
I 
+--org . dvb . net . re . ConnectionRCEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Direct Known Subclasses: 

ConnectionEstablishedEvent, Connect ionFailedEvent, 
Connect ionTerminatedEvent 

Description 

ConnectionRCEvent - the base class for events related to connection oriented return channels. 



Constructors 



ConnectionRCEvent(Obj ect) 

public ConnectionRCEvent (Java. lang. Object source) 

Construct an event 

Parameters: 

source - the ConnectionRCinterf ace for which the event was generated. 
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org.dvb.net.rc 

ConnectionRCInterface 



Declaration 

public class ConnectionRCInterface extends RCInterface implements 
org. davic . resources . Re source Proxy 

Java . lang .Object 

H org . dvb . net . re . RCInterface 

I 

+--org.dvb.net . re .ConnectionRCInterface 

All Implemented Interfaces: 

org. davic .resources . Re source Proxy 

Description 

This class models a connection based return channel network interface for use in receiving and transmitting IP 
packets over a return channel. Targets for connections are specified as strings including the number to dial. These 
strings can only include either numbers or a "+" character (as the first character only). 

When a ConnectionRCInterface instance is first obtained by an application, the current target shall be set to 
the default. Applications which wish to use a non-default target need to set this target before attempting to reserve 
the ConnectionRCInterface. This is because if the application does not have the permission to use the 
default target, the reserve ( ) method is required throw a SecurityException. 



Constructors 

ConnectionRCInterfaceQ 

protected ConnectionRCInterface () 

Constructor for instances of this class. Tinis constructor is provided for Vne use of implementations 
and specifications which extend this specification. Applications shall not define sub-classes of this 
class. Implementations are not required to behave correctly if any such application defined sub- 
classes are used. 



Methods 

addConnectionListener(ConnectionListener) 

public void addConnectionListener (org . dvb . net . re . ConnectionListener 1) 

Add a listener for events related to connections of this interface. 

Parameters: 

1 - the listener for the connection related events 
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connectQ 



public void connect ( ) 

throws lOException, PermissionDeniedException 

Connect this return channel to the current target. If this ResourceProxy does not have the underlying 
resource reserved then a PermissionDeniedException will be thrown. Where the underlying resource 
is reserved but at the time the method is called, it is known that connection is impossible then an 
lOException will be thrown. Apart from this, this method is asynchronous and completion or failure is 
reported through the event listener on this class. If a connection is already established when this 
method is called then the method call shall have no effect. 

The details of the current connection target shall be obtained from the ConnectionParameters 
instance which is the current target during the call to this method. Hence changes to that 
ConnectionParameters instance before a call to this method shall be taken account of during the 
method call. Changes after the call to this method shall have no effect on that connection. 

Throws: 

PermissionDeniedException - if this application does not own the resource 

j ava . io . lOException - if connection is known to be impossible at the time when the method 
is called 



disconnectQ 

public void disconnect ( ) 

throws PermissionDeniedException 

Disconnect this return channel from the current target. This method is asynchronous and completion 
is reported through the event listener on this class. This method does not release the underlying 
resource from the ResourceProxy. If no connection is established then this method shall have no 
effect. 

Throws: 

PermissionDeniedException - if this application does not own the resource 



getCUentQ 

public org. davic. resources .ResourceClient getClient ( ) 

Return the object which asked to be notified about withdrawl of the underlying resource. This is the 
object provided as the first parameter to the last call to the reserve method on this object. If this 
object does not have the underlying resource reserved then null is returned. 

Specified By: 

getClient in interface ResourceProxy 

Returns: 

the object which asked to be notified about withdrawal of the underlying physical resource from 
this resource proxy or null 

getConnectedTimeO 

public int getConnectedTimeO 

Return the time an interface has been connected 

Returns: 

the time in seconds for which this interface has been connected or -1 if the device is not 
connected 
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getCurrentTargetO 

public org.dvb.net . re .ConnectionParameters getCurrentTargetO 

throws IncompleteTargetException 

Get the current target for connections. 

If this ConnectionRCInterface is connected then this method shall return the target to which the 
connection was made. If this ConnectionRCInterface is not connected then this method shall return 
the last target set by the setTarget method (if any) otherwise the default. 

This returns either the default target or the last target set by this application calling the setTarget 
method on this instance before the connection was established. This applies regardless of whether 
the connection was established by another MHP application or if some of the connection parameters 
have been supplied by the server. 

Returns: 

the current set of connection target parameters 

Throws: 

IncompleteTargetException - if the current target is not completely configured 

j ava . lang . SecurityException - if the application is not allowed to read the current target 
as defined by the security policy of the platform 

getSetupTimeEstimateO 

public float getSetupTimeEstimateO 

Obtain an estimate of the setup time for a successful connection for this interface in seconds. 

Returns: 

an estimate of the setup time for a successful connection for this interface in seconds. 

isConnectedO 

public boolean isConnectedO 

Check if this interface is connected. Connected means able to receive and transmit packets. 

Returns: 

true if the interface is connected, otherwise false 

releaseO 

public void releaseO 

Release the right to control this return channel interface. If this object does not have the right to 
control this return channel interface then this method shall have no effect. 

removeConnectionListener(ConnectionListener) 

public void removeConnectionListener (org . dvb . net . re . ConnectionListener 1) 

Remove a listener for events related to connections of this interface. If the listener specified is not 
currently receiving these events then this method has no effect. 

Parameters: 

1 - the listener for the connection related events 
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reserve(ResourceClient, Object) 

public void reserve (org. davic . resources . ResourceClient c, Java . lang. Object requestData) 
throws PermissionDeniedException 

Request the right to control this return channel interface. If the right to control the return channel 
interface has already been reserved then this method shall have no effect. 

Parameters: 

c - the object to be notified when resources are removed 

requestData - Used by the Resource Notification API in the requestRelease method of the 
ResourceClient interface. The usage of this parameter is optional and a null reference may be 
supplied. 

Throws: 

PermissionDeniedException - if this interface cannot be reserved 

j ava . lang . SecurityException - if the application is denied access to the resource by 
security policy. 



setTarget(ConnectionParameters) 

public void setTarget (org . dvb . net . re . ConnectionParameters target) 

throws IncompleteTargetException, PermissionDeniedException 

Set a non-default target for connections. 

If this method is called for a ConnectionRCInterface which is connected then successful calls to this 
method shall not interrupt that connection. The newly set target shall just be stored until either the 
next time a connection is established with that ConnectionRCInterface instance or until a subsequent 
call to setTarget on that ConnectionRCInterface. 

The details of the current connection target shall be obtained from the newly set target during the call 
to the connect method. Hence changes to that ConnectionParameters instance before a call to 
the connect method shall be taken account of during the call to the connect method. Changes 
after the call to the connect method shall have no effect on that connection. 

Parameters: 

target - the new set of connection target parameters 

Throws: 

IncompleteTargetException - if the application owns the resource but the target is not 
completely specified 

PermissionDeniedException - if this application does not own the resource 

j ava . lang . SecurityException - if the application is not allowed to modify the target as 
defined by the security policy of the platform 



setTargetToDefaultO 

public void setTargetToDefaultO 

throws PermissionDeniedException 

Set the target for connections to the default. 

Throws: 

PermissionDeniedException - if this application does not own the resource 

j ava . lang . SecurityException - this exception shall never be thrown 
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org.dvb.net.rc 

ConnectionTerminatedEvent 



Declaration 

public class ConnectionTerminatedEvent extends ConnectionRCEvent 

Java . lang .Object 

+ — java.util .EventObject 
I 
+--org . dvb . net . re . ConnectionRCEvent 

+ — org . dvb . net . re . ConnectionTerminatedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

ConnectionTerminatedEvent - An event generated after a connected Connection RC Interface is 
disconnected. 



Constructors 



ConnectionTerminatedEvent(Object) 

public ConnectionTerminatedEvent (Java. lang. Object source) 

Construct an event. 

Parameters: 

source - the ConnectionRCinterf ace whose Status changed 
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org.dvb.net.rc 

IncompleteTargetException 

Declaration 

public class IncompleteTargetException extends j ava . lang .Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . dvb . net . re . IncompleteTargetException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Thrown when the target for a connection is incompletely specified. This is thrown either when the default 
connection target is incompletely defined in the device or when an application provides an incompletely defined 
connection target to the device or when the connection target is badly formed, e.g. includes illegal characters in a 
number parameter. 



Constructors 

IncompleteTargetExceptionO 

public IncompleteTargetException () 

Default constructor for the exception 
IncompleteTargetException(String) 

public IncompleteTargetException (j ava . lang . String reason) 

Constructor for the exception with a specified reason 

Parameters: 

reason - the reason why the exception was raised 



ETSI 



632 ETSITS 101 812V1.3.1 (2003-06) 



org.dvb.net.rc 

PermissionDeniedException 



Declaration 

public class PermissionDeniedException extends j ava . lang .Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org.dvb .net . re. PermissionDeniedException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Thrown when an apphcation calls a method which it does not have permission to call at that time. 



Constructors 

PermissionDeniedExceptionO 

public PermissionDeniedExceptionO 

Default constructor for the exception 
PermissionDeniedException(String) 

public PermissionDeniedException (j ava . lang . String reason) 

Constructor for the exception with a specified reason 

Parameters: 

reason - the reason why the exception was raised 
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org.dvb.net.rc 

RCInterface 



Declaration 

public class RCInterface 
Java . lang .Object 

+ — org . dvb . net . re . RCInterface 

Direct Known Subclasses: 

Connect ionRC Inter face 

Description 

This class models a return channel network interface for use in receiving and transmitting IP packets over a logical 
return channel. This can include real analog modems, cable return channel and all the other options allowed by the 
relevant DVB specification. This class does not model any concept of connection. Hence interfaces represented by 
this class and not by a sub-class of it are permanently connected. 



Fields 

TYPE_CATV 

public static final int TYPE_CATV 

Constant to indicate a CATV return cinannel. 
TYPE_DECT 

public static final int TYPE_DECT 

Constant to indicate a DECT return cinannel. 
TYPEJSDN 

public static final int TYPE_ISDN 

Constant to indicate an ISDN return cinannel. 
TYPE_LMDS 

public static final int TYPE_LMDS 

Constant to indicate a LIVIDS return cinannel. 
TYPE_MATV 

public static final int TYPE_MATV 

Constant to indicate a IVIATV return cinannel. 
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TYPE_OTHER 

public static final int TYPE_OTHER 

Constant to indicate all other return channel technologies not having a suitable defined constant in 
this class. 

NOTE: DVB does not intend to add future constants to this list for future return channel technologies. 
These should be represented as TYPE_OTHER. 



TYPE_PSTN 

public static final int TYPE_PSTN 

Constant to indicate a PSTN return channel. 
TYPE_RCS 

public static final int TYPE_RCS 

Constant to indicate a DVB-RCS return channel. 
TYPE_UNKNOWN 

public static final int TYPE_UNKNOWN 

Constant to indicate an unknown return channel technology. There is an intermediate physical 
interface between the MHP terminal and the return channel device. This return value gives no 
information about whether the return channel is connection oriented or connectionless. 



Constructors 



RCInterfaceO 

protected RCInterfaceO 

Constructor for instances of this class. This constructor is provided for the use of implementations 
and specifications which extend this specification. Applications shall not define sub-classes of this 
class. Implementations are not required to behave correctly if any such application defined sub- 
classes are used. 



Methods 



getDataRateO 

public int getDataRateO 

Return the maximum data rate of the connection over the immediate access network to which this 
network interface is connected. For asymetric connections, the data rate coming into the MHP 
terminal shall be returned. For connection oriented interfaces which are not currently connected, the 
value returned shall be that of the last connection established where that information is available. 
Where that information is not available, (e.g. where no connection has been established since an 
MHP terminal was power cycled), -1 shall be returned. 
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Returns: 

a data rate in KBaud or -1 where this is not available 

Since: 

MHP 1.0.1 



getTypeO 



public int getTypeO 

Return the type of return channel represented by this object. Note, applications wishing to discover 
whether a return channel interface is connection oriented or not are recommended to test whether 
an object is an instance of ConnectionRCinterf ace or not. A non-connection oriented interface 
really means a permanently connected return channel. 

Returns: 

the type of return channel represented by this object encoded as one of the constants defined in 
this class 
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org.dvb.net.rc 

RCInterfaceManager 



Declaration 

public class RCInterfaceManager implements org. davic . resources . ResourceServer 
Java . lang .Object 

+ — org . dvb . net . re . RCInterfaceManager 

All Implemented Interfaces: 

org. davic .resources . ResourceServer 

Description 

This class is the factory and manager for all return channel interfaces in the system. The methods on this class 
which return instances of the RCInterface will only return new instances of that class under the following 
conditions :- 

• on the first occasion an instance needs to be returned to a particular application for a particular interface. 

• when new return channel interfaces are added to the system 



Methods 



addResourceStatusEventListener(ResourceStatusListener) 

public void addResourceStatusEventListener (org . davic . resources . ResourceStatusListener 
listener) 

This method informs a resource server that a particular object should be informed of changes in the 
state of the resources managed by that server. 

Specified By: 

addResourceStatusEventListener in interface ResourceServer 

Parameters: 

listener - the object to be informed of state changes 



getlnstanceO 

public static org . dvb . net . re . RCInterfaceManager getlnstanceO 

Factory method to obtain a manager. The RCInterfaceManager is either a singleton for each MHP 
application or a singleton for the MHP terminal. 

Returns: 

an instance of an RCInterfaceManager 

getlnterface(InetAddress) 

public org.dvb.net . re .RCInterface getlnterf ace (Java . net . InetAddress addr) 

Return the interface which will be used when connecting to a particular host. Null is returned if this is 
not known when the method is called. 
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Parameters: 

addr - the IP address of the host to connect to 

Returns: 

the interface which will be used or null if this is not known 



getlnterface(Socket) 

public org.dvb.net . re .RCInterf ace getlnterf ace (Java . net . Socket s) 

Return the interface which is used for a particular socket. 

Parameters: 

s - the socket to use 

Returns: 

the interface which is used or null if the socket isn't connected 

getlnterface(URLConnection) 

public org . dvb . net . re .RCInterf ace getlnterf ace (Java . net . URLConnection u) 

Return the interface which is used for a particular URLConnection 

Parameters: 

u - the URLConnection to use 

Returns: 

the interface which is used or null if the URLConnection isn't connected 

getlnterfacesO 

public org.dvb.net . re .RCInterf ace[ ] getlnterfacesO 

Factory method to return a list of all return channel interfaces visible to this application. The number 
of entries in the array will exactly match the number of return channel interfaces visible to the 
application. Null is returned if no interfaces are visible to this application. 

Returns: 

an array of available return channel interfaces 

removeResourceStatusEventListener(ResourceStatusListener) 

public void removeResourceStatusEventListener (org . davic . resources . ResoureeStatusListener 
listener) 

This method informs a resource server that a particular object is no longer interested in being 
informed about changes in state of resources managed by that server. If the object had not 
registered its interest initially then this method has no effect. 

Specified By: 

removeResourceStatusEventListener in interface ResourceServer 

Parameters: 

listener - the object which is no longer interested 
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org.dvb.net.rc 

RCInterfaceReleasedEvent 



Declaration 

public class RCInterfaceReleasedEvent extends org . davic . resources . ResourceStatusEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I org . davic . resources .ResourceStatusEvent 

+ — org.dvb .net . re . RCInterfaceReleasedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event informs an application that a RCInter f ace has been released by an application or other entity in the 
system. It is generated when an application which had successfully reserved a RCInterf ace calls the 
ConnectionRCInterface . release method. It will also be generated if any other entities in the system 
own such an interface and then release that interface in such a way that it could then become available to 
applications using this API. 



Constructors 

RCInterfaceReleasedEvent(Object) 

public RCInterfaceReleasedEvent (Java . lang. Object bg) 

Constructor for the event 

Parameters: 

bg - the RCInterf ace which has been released 



Methods 



getSourceO 

public Java. lang. Object getSource ( ) 

Returns the device that has been released 

Overrides: 

getSource in class ResourceStatusEvent 

Returns: 

the RCInterf ace object representing the interface that has been released 
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org.dvb.net.rc 

RC I nterfaceReserved Event 



Declaration 

public class RCInterfaceReservedEvent extends org . davic . resources . ResourceStatusEvent 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
-I org . davic . resources .ResourceStatusEvent 

+ — org.dvb .net . re . RCInterfaceReservedEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This event informs an application that a RCInter f ace has been reserved by an apphcation or other entity in the 
system. It is generated when an application successfully reserves a RCInter face. It will also be generated if any 
other entities in the system reserve such an interface with the effect of something which was visible to applications 
using this API becoming unavailable. 



Constructors 

RCInterfaceReservedEvent(Obj ect) 

public RCInterfaceReservedEvent (Java . lang. Object bg) 

Constructor for the event 

Parameters: 

bg - the RCinterf ace representing the device which has been reserved 



Methods 



getSourceO 

public j ava . lang. Obj ect getSource ( ) 

Returns the device that has been reserved 

Overrides: 

getSource in class ResourceStatusEvent 

Returns: 

an RCinterf ace representing the device that has been reserved 
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org.dvb.net.rc 

RCPermission 



Declaration 

public class RCPermission extends j ava . security . BasicPermission 

Java . lang .Object 

H j ava . security. Permission 

I 

-I Java .security. BasicPermission 

+ — org.dvb .net . re. RCPermission 

All Implemented Interfaces: 

j ava .security. Guard, j ava .io.Serializable 

Description 

This class is for return channel set-up permissions. An RCPermission contains a name, but no actions list. 

The permission name can be "target:default", which indicates the permission to use the default connection 
parameters. 

The permission name can also be "target :<phone number>", which indicates the permission to use the specified 
phone number in the connection set-up (ConnectionRCInterface.setTarget(ConnectionParameters) method). 

A wildcard may be used at the end of the permission name. In that case, all phone numbers starting with the 
number before the wildcard are included in the permission. A "-I-" may be used at the start of the phone number to 
indicate a phone number including the international country code. 

Examples: 

• target:0206234342 (Permission to dial the specified phone number) 

• target:020* (Permission to dial phone numbers starting with 020) 

• target:* (Permission to dial all phone numbers, including the default) 

Note: ConnectionRCInterface.reserve(ResourceClient, Object) will throw a SecurityException if the application is 
not allowed to set-up a connection over the return channel at all (i.e., there is no valid target allowed). 



Constructors 



RCPermission(String) 

public RCPermission (Java . lang . String name) 

Creates a new RCPermission witii tiie specified name. Tine name is tine symbolic name of tiie 
RCPermission. 

Parameters: 

name - the name of tine RCPermission 
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RCPermission(String, String) 

public RCPermission (Java . lang . String name, j ava . lang . String actions) 

Creates a new RCPermission object witin ihe specified name. Tine name is tiie symbolic name of tine 
RCPermission, and tine actions String is unused and sinould be null. This constructor exists for use 
by the Policy object to instantiate new Permission objects. 



Parameters: 

name - the name of the RCPermission 

actions - should be null. 



Methods 



implies(Permission) 

public boolean implies (Java . security . Permission p) 

Checks if this RCPermission "implies" the specified Permission. 
More specifically, this returns true if and only if: 

• p is an instance of RCPermission, and 

• p's name is implied by the name of this permission, as described by the wildcarding rales specified in the 
the description of this class. 

Overrides: 

implies in class BasicPermission 

Parameters: 

p - The Permission to check against. 
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Annex S (normative): Application Listing and 
Launching 
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Package 

org.dvb.application 



Description 

Provides access to lists of applications which are available in this context and the ability to launch those 
applications. 



Class Summary 



Interfaces 

AppAt tributes 

AppProxy 

AppsDatabaseEventLis- 
tener 

AppStateChan- 
geEventListener 

DVBHTMLProxy 
DVBJProxy 

Classes 

Applcon 

AppID 
AppsControlPermission 

AppsDatabase 
AppsDatabaseEvent 

AppsDatabaseFilter 
AppStateChangeEvent 

CurrentServiceFilter 



Runn ingAppli cat ions - 
Filter 



Exceptions 

IllegalProf ileParame- 
terException 



The AppAttributes class is a mapping of various information about a regis- 
tered application. 

An AppProxy Object is a proxy to an application. 

The AppsDatabaseListener class allows an application to monitor the 
application database so that it can keep an up to date interface without polling 
the state. 

The AppStateChangeEventListener class allows a launcher application 
to keep track of applications it launches or other applications running as part of 
the same service. 

A DVBHTMLProxy Object is a proxy to a DVBHTML application. 

A DVBJProxy Object is a proxy to a DVBJ application. 



The Applcon encapsulates the information concerning the icon attached to 
the application 

The AppiD is a representation of the unique identifier for applications. 

This class represents a Permission to control the lifecycle of another applica- 
tion. 

The AppsDatabase is an abstract view of the currently available applications. 

The AppsDatabaseEvent class indicates either an entry in the application 
database has changed, or so many changes have occurred. 

Abstract class for the filters. 

The AppStateChangeEvent class indicates a state transition of the applica- 
tion. 

Instances of CurrentServiceFilter are used to set a filter on the list of 
applications that are retrieved from the AppsDatabase (See methods getApps- 
Attributes and getAppslDs). 

Instances of RunningApplicationsFilter are used to set a filter on the 
list of applications that are retrieved from the AppsDatabase (See methods 
getAppsAttributes and getAppslDs). 



The IllegalProf ileParameter exception is thrown if the application 
attempts to ask for a version number for a profile not specified for the applica- 
tion. 
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Class Summary 



LanguageNotAvailable- Jhe LanguageNotAvailableException exception is tlirown if tlie applica- 
Exception tjon asks for the name of an application in a language not signalled in the AIT. 
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org.dvb.application 

AppAttributes 

Declaration 

public interface AppAttributes 

Description 

The AppAttributes class is a mapping of various infonnation about a registered application. For applications 
which are signalled in an AIT, the mapping between the values returned by methods in this class and the fields and 
descriptors of the AIT shall be as specified in the main body of this specification. 

Instances of objects implementing this interface are immutable and populated before the instance is first returned to 
an application. 

Since: 

MHP1.0 



Fields 

DVB_HTML_application 

public static final int DVB_HTML_application 

The DVB registered value for all DVB-HTML applications. 
DVB_J_application 

public static final int DVB_J_application 

The DVB registered value for all DVB-J applications. 



Methods 



getAppIconO 

public org . dvb . application .Applcon getAppIconO 

This method returns an object encapsulating the information about the icon(s) for the application. 

Returns: 

the information related to the icons that are attached to the application or null if no icon 
information is available 

Since: 

MHP1.0 
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getldentiflerQ 

public org . dvb . application .AppID getldentifier ( ) 

This method returns the application identifier. 

Returns: 

the application identifier 

Since: 

MHP1.0 



getlsServiceBoundQ 

public boolean getlsServiceBound ( ) 

This method determines whether the application is bound to a single service. 

Returns: 

true if the application is bound to a single service, false otherwise. 



Since: 

MHP1.0 



getNameO 

public Java . lang. String getName ( ) 

This method returns the name of the application. If the default language (as specified in user 
preferences) is in the set of available language / name pairs then the name in that language shall be 
returned. Otherwise this method will return a name which appears in that set on a "best-effort basis". 
If no application names are signalled, an empty string shall be returned. 



Returns: 

the name of the application 

Since: 

MHP1.0 



getName(String) 

public Java . lang. String getName (Java . lang . String iso639code) 
throws LanguageNotAvailableException 

This method returns the name of the application in the language which is specified by the parameter 
passed as an argument. If the language specified is not in the set of available language /name pairs 
then an exception shall be thrown. 

Parameters: 

iso63 9code - the specified language, encoded as per ISO 639. 

Returns: 

returns the name of the application in the specified language 

Throws: 

LanguageNotAvailableException - if the name is not available in the language specified or 
if the parameter passed is null 

Since: 

MHP1.0 
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getNamesO 

public Java. lang. String[ ] [ ] getNamesO 

This method returns all the available names for the application together with their ISO 639 language 
code. If no application names are signalled, an array of length zero shall be returned. 

Returns: 

the possible names of the application, along with their ISO 639 language code. The first string in 
each sub-array is the ISO 639 language code. The second string in each sub-array is the 
corresponding application name. 

Since: 

MHP1.0 

getPriorityO 

public int getPriorityO 

This method returns the priority of the application. 

Returns: 

the priority of the application. 

Since: 

MHP1.0 

getProfllesO 

public Java . lang. String[ ] getProf iles ( ) 

This method returns those minimum profiles required for the application to execute. Profile names 
shall be encoded using the same encoding specified elsewhere in this specification as input for use 
with the Java. lang. System. getProperty method to query if a profile is supported by this 
platform. 

For example, for implementations conforming to the first version of the specification, the translation 
from AIT signaling values to strings shall be as follows : 

• ' r in the signaling will be translated into 'mhp.profile.enhanced_broadcast' 

• '2' in the signaling will be translated into 'mhp.profile.interactive_broadcast' 

Only profiles known to this particular MHP terminal shall be returned. Hence the method can return 
an array of size zero where all the profiles on which an application can execute are unknown. 

Returns: 

an array of Strings, each String describing a profile. 

Since: 

MHP1.0 

getProperty(String) 

public Java . lang. Obj ect getProperty (Java . lang . String index) 

The following method is included for properties that do not have explicit property accessors. The 
naming of properties and their return values are described in the main body of this specification. 

Parameters: 

index - a property name 

Returns: 

either the return value corresponding to the property name or null if the property name is 
unknown or null 
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Since: 

MHP1.0 



getServiceLocatorO 

public org. davic. net . Locator getServiceLocatorO 

This method returns the locator of the Service describing the application. For an application 
transmitted on a remote connection, the returned locator shall be the service for that remote 
connection. For applications not transmitted on a remote connection, the service returned shall be 
the currently selected service of the service context within which the application calling the method is 
running. 



Returns: 

the locator of the Service describing the application. 

Since: 

MHP1.0 



getTypeO 

public int getTypeO 

This method returns the type of the application ( as registered by DVB). 

Returns: 

the type of the application ( as registered by DVB). 



Since: 

MHP1.0 



getVersions(String) 

public int[] getVersions (j ava . lang . String profile) 

throws IllegalProf ileParameterException 

This method returns an array of integers containing the version number of the specification required 
to run this application at the specified profile. 

Parameters: 

profile - a profile encoded as described in the main body of this specification for use with 

Java. lang. System. get Property. 

Returns: 

an array of integers, containing the major, minor and micro values (in that order) required for the 
specified profile. 

Throws: 

IllegalProf ileParameterException - thrown if the profile specified is not one of the 
minimum profiles required for the application to execute or if the parameter passed in is null 

Since: 

MHP1.0 
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isStartableO 

public boolean isStartableO 

This method determines whether the application is startable or not. An Application is not startable if 
any of the following apply. 

• The application is transmitted on a remote connection. 

• The caller of the method does not have the Permissions to start it. 

• if the application is signalled with a control code which is neither AUTOSTART nor PRESENT. 
If none of the above apply, then the application is startable. 

The value returned by this method does not depend on whether the application is actually running or 
not. 

Returns: 

true if an application is startable, false otherwise. 

Since: 

MHP1.0 



isVisibleO 

public boolean isVisibleO 

This method determines whether the application is marked as being visible to users. An inter- 
operable application shall honour this visibility setting. Thus a generic launching application shall list 
applications that are marked as visible and shall not list applications that are not marked as visible. 

Returns: 

true if this application is marked as being visible to users, false otherwise. 

Since: 

MHP1.0.3 
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org.dvb.application 

Applcon 



Declaration 

public class Applcon 
Java . lang .Object 

+ — org . dvb . application . Applcon 

Description 

The Applcon encapsulates the information concerning the icon attached to the application 



Constructors 

AppIconQ 

protected Applcon () 

The constructor for the class. This constructor is intended for implementation convenience and 
evolution of the specification and not for use by MHP applications. Applications should obtain 
instances of this class from AppAttributes . getAppicon. 

See Also: 

AppAttributes . getAppicon ( ) 



Methods 

getlconFlagsO 

public java.util .BitSet getlconFlagsO 

This method returns the flags identifying which icons are provided for the application. 

Returns: 

the icon flags encoded as a BitSet 

Since: 

MHP1.0 

getLocatorQ 

public org . davic . net . Locator getLocator ( ) 

This method returns the location of the directory containing the application icons. 

Returns: 

the location of the directory containing the application icons. 

Since: 

MHP1.0 
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org.dvb.application 

AppID 

Declaration 

public class AppID 
Java . lang .Object 

+ — org . dvb . application . AppID 

Description 

The AppID is a representation of the unique identifier for applications. 

Its string form is the Hex representation of the 48 bit number. 



Constructors 



AppID(int, int) 

public AppID (int oid, int aid) 

Create a new AppID based on the given integers. Tiiere is no range cliecl<ing on tiiese numbers. 



Parameters: 

oid - the globally unique organization number. 

aid - the unique count within the organization. 

Since: 

MHP1.0 



Methods 



equals(Object) 

public boolean equals (j ava . lang. Object obj) 

Compares two ApplDs for equality. 

Overrides: 

equals in class Object 

Parameters: 

obj - the reference object with which to compare. 

Returns: 

true if this obj is an AppID and its Organisation ID and its Application ID match the ID's for this 
AppID; false otherwise. 
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getAIDO 

public int getAIDO 

This method returns the integer value of the application count supplied in the constructor 

Returns: 

the integer value of the application count supplied in the constructor 



Since: 

MHP1.0 



getOIDO 

public int getOID ( ) 

This method returns the integer value of the organization number supplied in the constructor. 

Returns: 

the integer value of the organization number supplied in the constructor. 



Since: 

MHP1.0 



hashCodeO 

public int hashCode ( ) 

Returns a hash code value for this ApplD. The hashcode for two ApplD's with the same Organisation 



ID and Application ID are equal. 

Overrides: 

hashCode in class Object 

Returns: 

a hash code value for this ApplD 



toStringO 

public Java . lang. String toString ( ) 

This method returns a string containing the Hex representation of the 48 bit number. The string shall 
be formatted as specified in the section on "Text encoding of application identifiers" in the System 
Integration chapter of the MHP specification. 

Overrides: 

toString in class Object 

Returns: 

a string containing the Hex representation of the 48 bit number. 

Since: 

MHP1.0 
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org.dvb.application 

App Proxy 

Declaration 

public interface AppProxy 

All Known Subinter faces: 

DVBHTMLProxy, DVBJProxy 

Description 

An AppProxy Object is a proxy to an application. A call to the start, stop or pause will cause the resident 
Application Manager to respectively start, stop or pause the application bound to this AppProxy object. Each of 
these three method calls can throw a Security Exception if the calling application is not entitled to do so. 

Each of these method calls are asynchronous and will result in exactly one AppStateChangedEvent to be generated 
whether the method call was successful or not. If the method call was not successful, any call to the hasFailed 
method of the corresponding AppStateChangeEvent will return true. 

Some of the methods here allow the AppProxy to transition through several states before the final state is reached. 
If this compound state transition is unsuccessful at any point, the resulting AppStateChangedEvent shall have a 
fromstate which is the last state in this transition which the AppProxy successfully entered and a toState which 
would have been the next state in the compound state transition. 

For instance, if an application were to call start on an AppProxy for a DVB -J application in the NOT_LOADED 
state and that DVB -J application was to throw a XletStateChangeException from its startXlet method, the 
getFromState will return PAUSED and getToState will return STARTED. If an application were to call start on an 
AppProxy for a DVB-J application in the NOT_LOADED state and that DVB-J application was to throw a 
XletStateChangeException from its initXlet method, the getFromState will return NOT_LOADED and getToState 
will return PAUSED. Calling the start method for an application which is already running shall fail and generate an 
AppStateChangeEvent with hasFailed returning true and both fromstate and tostate being STARTED.! 

See the definition of AppStateChangeEvent for more information. 

See Also: 

AppStateChangeEvent 



Fields 



DESTROYED 

public static final int DESTROYED 

The application is in Vne destroyed state. Tiiis state is transient and entry to this state shall be 
followed with a transition to the NOT_LOADED state almost immediately. It shall be possible to re- 
start the application after the transition to the NOT_LOADED state. 

NOT_LOADED 

public static final int NOT_LOADED 

The application has not yet been loaded from the network at all. 
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PAUSED 



public static final int PAUSED 

The application is in \he paused state. 



STARTED 



public static final int STARTED 

Tiie application is in the active state. 



Methods 



addAppStateChangeEventListener(AppStateChangeEventListener) 

public void addAppStateChangeEventListener (org. dvb . application .AppStateChangeEventListener 
listener) 

Add a listener to the application proxy so that an application can be informed if the application 
changes state. 

Parameters: 

listener - the listener to be added. 

Since: 

MHP1.0 



getStateO 

public int getState () 

Return the current state of the application. 

Returns: 

the state of the application. 

pauseQ 

public void pause ( ) 

Request that the application manager pause the application bound to this information structure. 

The application will be paused. Calls to this method shall fail if the application is not in the active 
state. If the application represented by this AppProxy is a DVB-J application, calling this method will, 
if successful, result in the pausexiet method being called on the Xlet making up the DVB-J 
application. 

Throws: 

j ava . lang . SecurityException - if the application is not entitled to pause this application. 
Note that if an application is entitled to stop an application, it is also entitled to pause it : having 
the right to stop an application is logically equivalent to having the right to pause it. 

Since: 

MHP1.0 
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removeAppStateChangeEventListener(AppStateChangeEventListener) 

public void 

removeAppStateChangeEventListener (org. dvb . application . AppStateChangeEventListe 
ner listener) 

Remove a listener on the database. 



Parameters: 

listener - the listener to be removed. 

Since: 

MHP1.0 



resumeO 

public void resume ( ) 

Request that the application manager resume the execution of the application. The application 
will be started. This method will throw a security exception if the application does not have the 
authority to resume the application. Calls to this method shall fail if the application is not in the 
paused state. 

This method is asynchronous and its completion will be notified by an AppStateChangedEvent. In 
case of failure, the hasFailed method of the AppStateChangedEvent will return true. If the 
application represented by this AppProxy is a DVB-J application, calling this method will, if 
successful, result in the startxiet method being called on the Xlet making up the DVB-J 
application. 

Throws: 

j ava . lang . SecurityException - if the application is not entitled to resume this application. 

Since: 

MHP1.0 

startO 

public void start ( ) 

Request that the application manager start the application bound to this information structure. 

The application will be started. This method will throw a security exception if the application does 
not have the authority to start applications. Calls to this method shall only succeed if the application 
if the application is signalled with a control code which is either AUTOSTART or PRESENT and any 
one of the following applies: 

• if the application (DVB-J or DVB-HTML) is in the not loaded or paused states, 

• if a DVB-J application is in the "loaded" state, 

• if a DVB-HTML application is in the "loading" state. 

If the application was not loaded at the moment of this call, then the application will be started. In the 
case of a DVB-J application, it will be initialized and then started by the Application Manager, hence 
causing the Xlet to go from NotLoaded to Paused and then from Paused to Active. If the application 
was in the Paused state at the moment of the call and had never been in the Active state, then the 
application will be started. If the application represented by this AppProxy is a DVB-J application, 
calling this method will, if successful, result in the startxiet method being called on the Xlet 
making up the DVB-J application. 

This method is asynchronous and its completion will be notified by an AppStateChangedEvent. In 
case of failure, the hasFailed method of the AppStateChangedEvent will return true. 

Throws: 

j ava . lang . SecurityException - if the application is not entitled to start this application. 

Since: 

MHP1.0 
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start(String[l) 

public void start (j ava . lang. String[ ] args) 

Request that the application manager start the application bound to this information structure 
passing to that application the specified parameters. 

The application will be started. This method will throw a security exception if the application does 
not have the authority to start applications. Calls to this method shall only succeed if the application 
if the application is signalled with a control code which is either AUTOSTART or PRESENT and any 
one of the following applies: 

• if the application (DVB-J or DVB-HTML) is in the not loaded or paused states, 

• if a DVB-J application is in the "loaded" state, 

• if a DVB-HTML application is in the "loading" state. 

If the application was not loaded at the moment of this call, then the application will be started. In the 
case of a DVB-J application, it will be initialized and then started by the Application Manager, hence 
causing the Xlet to go from NotLoaded to Paused and then from Paused to Active. If the application 
was in the Paused state at the moment of the call and had never been in the Active state, then the 
application will be started. If the application represented by this AppProxy is a DVB-J application, 
calling this method will, if successful, result in the startxiet method being called on the Xlet 
making up the DVB-J application. 

This method is asynchronous and its completion will be notified by an AppStateChangedEvent. In 
case of failure, the hasFailed method of the AppStateChangedEvent will return true. 

Parameters: 

args - the parameters to be passed into the application being started 

Throws: 

j ava . lang . SecurityException - if the application is not entitled to start this application. 



Since: 

MHP1.0.1 



stop(boolean) 

public void stop (boolean forced) 

Request that the application manager stop the application bound to this information structure. 

The application will be stopped. A call to this method shall fail if the application was already in 
the destroyed state. This method call will stop the application if it was in any other state before the 
call. If the application is in the NOT_LOADED state then it shall move directly to the DESTROYED 
state with no other action being taken. If the application represented by this AppProxy is a DVB-J 
application and is not in the DESTROYED state then calling this method will, if successful, result in 
the destroyxiet method being called on the Xlet making up the DVB-J application with the same 
value for the parameter as passed to this method. 

This method is asynchronous and its completion will be notified by an AppStateChangedEvent. In 
case of failure, the hasFailed method of the AppStateChangedEvent will return true. 

Parameters: 

forced - if true then do not ask the application but forcibly terminate it, if false give the 
application an opportunity to refuse. 

Throws: 

j ava . lang . SecurityException - if the application is not entitled to stop this application. 

Since: 

MHP1.0 
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org.dvb.application 

AppsControlPermission 



Declaration 

public final class AppsControlPermission extends j ava . security . BasicPermission 

Java . lang .Object 

H j ava . security. Permission 

I 

-I Java .security. BasicPermission 

+ — org . dvb . application . AppsControlPermission 

All Implemented Interfaces: 

j ava .security. Guard, j ava .io.Serializable 

Description 

This class represents a Permission to control the lifecycle of another application. 



Constructors 

AppsControlPermissionO 

public AppsControlPermissionO 

Creates a new AppsControlPermission. Tinere is a simple mapping between the Application control 
Permission requests and the way the AppsControlPermission are granted. This mapping is defined 
in the main body of this specification. 

AppsControlPermission(String, String) 

public AppsControlPermission (j ava . lang . String name, Java . lang . String actions) 

Creates a new AppsControlPermission. There is a simple mapping between the Application control 
Permission requests and the way the AppsControlPermission are granted. This mapping is defined 
in the main body of this specification. The actions string is currently unused and should be null. The 
name string is currently unused and should be empty. This constructor exists for use by the 
java.security.Policy object to instantiate new permission objects. 

Parameters: 

name - the name of the permission 

actions - the actions string 
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Methods 



equals(Object) 

public boolean equals (j ava . lang. Object obj) 

Checks for equality against tinis AppsControlPermission object. 

Overrides: 

equals in class BasicPermission 

Parameters: 

obj - tine object to test for equality with this AppsControlPermission object. 

Returns: 

true if and only if obj is an AppsControlPermission 

getActionsO 

public Java. lang. String getActionsO 

Returns the list of actions that had been passed to the constructor - it shall return null. 

Overrides: 

getActions in class BasicPermission 

Returns: 

a null String. 



hashCodeO 

public int hashCode ( ) 

Returns the hash code value for this object. 

Overrides: 

hashCode in class BasicPermission 

Returns: 

the hash code value for this object. 



implies(Permission) 

public boolean implies (Java . security . Permission permission) 

Checks if this AppsControlPermission object "implies" the specified permission. 

Overrides: 

implies in class BasicPermission 

Parameters: 

permission - the specified permission to check. 

Returns: 

true if and only if the specified permission is an instanceof AppsControlPermission 
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org.dvb.application 

AppsDatabase 

Declaration 

public class AppsDatabase 
Java . lang .Object 

+ — org . dvb . application . AppsDatabase 

Description 

The AppsDatabase is an abstract view of the currently available applications. The entries will be provided by 
the application manager, and gleaned from the AIT signaling. When the service context in which an application is 
running undergoes service selection, instances of AppsDatabase used by that application shall be updated from 
the new service before an AppsDatabaseEvent is sent to the newDatabase method of any registered 
AppsDatabaseEventListeners. For applications fully signalled in the current service (i.e. excluding 
externally authorised ones), the attributes entries shall be the ones from the signalling of the current service even if 
the application was originally launched from another service and then survived service selection. For running 
externally authorised applications, the entries will be those from the last service in which they ran fully signalled. 

Externally authorized applications shall not appear unless an instance of that application is actually running. 

A generic launcher may be written which uses the database to display information in AppAttributes and uses an 
AppProxy to launch it 

Methods on classes in this package do not block, they return the information the system currently has. Therefore 

applications should be aware that data may be stale, to within one refresh period of the AIT. 

eg: 

AppsDatabase theDatabase = AppsDatabase . getDatabase () ; 
if (theDatabase != null ) { 

Enumeration attributes = theDatabase . getAppAttributes () ; 
if (attributes != null) { 

while (attributes . hasMoreElements ( ) ) { 
AppAttributes info ; 
AppProxy proxy ; 

info = (AppAttributes) attributes . nextElement ; 

proxy = (AppProxy ) theDatabase . getAppProxy (info . getldentifier ( ) ) ; 

URL icon = inf o . getlcon ( ) ; 

// blah blah. . 

// lets start it. 

proxy . start (false, null); 



Where methods on this class as specified as working on "available" applications or "currently available" 
applications the following definition shall apply. An application is "currently available" if and only if one of the 
following applies in the service context within which the application calling the method is executing. 

• it is signalled as being present or autostart in the currently selected service of that service context and could be 
started. 

• it is currently running in that service context. 

In addition to the methods listed below, all calls made using an AppsDatabaseFilter shall only use that filter to test 
"currently available" applications as defined here. 

Applications whose information (e.g. signaling) is invalid (e.g. one or more mandatory descriptors are missing or 
incorrect) may not be listed in the AppsDatabase. Where applications are signalled in a broadcast AIT and the MHP 
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terminal tunes away from the service on which the AIT is carried, but without selecting a new service, the 
AppsDatabase shall retain the entries as signalled in that AIT until a new service is selected. 



Constructors 



AppsDatabaseO 

protected AppsDatabaseO 

This constructor is provided for tiie use of implementations and specifications wiiicii extend tinis 
specification. Applications shall not define sub-classes of this class. Implementations are not 
required to behave correctly if any such application defined sub-classes are used. 



Methods 



addListener(AppsDatabaseEventListener) 

public void addListener (org. dvb . application .AppsDatabaseEventListener listener) 

Add a listener to the database so that an application can be informed if the database changes. 

Parameters: 

listener - the listener to be added. 

Since: 

MHP1.0 



getAppAttributes(AppID) 

public org . dvb . application .AppAttributes getAppAttributes (org . dvb . application .AppID key) 

Returns the properties associated with the given ID. Returns null if no such application is available. 

Only one AppAttributes object shall be returned in the case where there are several applications 
having the same (organisationid, applicationid) pair. In such a case, the same algorithm as would be 
used to autostart such applications shall be used to decide between the available choices by the 
implementation. 

This method shall return instances which reflect the contents of the database at the time the method 
is called. After an AppsDatabaseEvent has been generated, new instances may be returned. After a 
service selection has taken place, applications which survived the service selection may call this 
method in order to discover the attributes of the applications signalled on the new service. 

Parameters: 

key - an application ID. 

Returns: 

the value to which the key is mapped in this dictionary or null if the key is not an application ID, 
or not mapped to any application currently available. 

Since: 

MHP1.0 
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getAppAttributes(AppsDatabaseFilter) 

public Java . util . Enumeration getAppAttributes (org . dvb . application . AppsDatabaseFilter 
filter) 

Returns an enumeration of AppAttributes of the applications available. The Enumeration will contain 
the set of AppAttributes that satisfy the filtering criteria. For implementations conforming to this 
version of the specification, only CurrentServiceFilter or RunningApplicationsFilter 
filters may return a non empty Enumeration. If the filter object is not an instance of 
CurrentServiceFilter or RunningApplicationsFilter or a subclass of either then, the 
method shall return an empty Enumeration. 

This method shall return instances which reflect the contents of the database at the time the method 
is called. After an AppsDatabaseEvent has been generated, new instances may be returned. After a 
service selection has taken place, applications which survived the service selection may call this 
method in order to discover the attributes of the applications signalled on the new service. 

This method will return an empty Enumeration if there are no attributes. 

Parameters: 

filter - the filter to apply 

Returns: 

an enumeration of the applications attributes. 

Since: 

MHP1.0 



getAppIDs(AppsDatabaseFilter) 

public Java . util . Enumeration getAppIDs (org. dvb . application .AppsDatabaseFilter filter) 

Returns an enumeration of the application ID's available. The Enumeration will contain the set of 
AppID that match the filtering criteria. For implementations conforming to this version of the 
specification, only CurrentServiceFilter or RunningApplicationsFilter filters may return 
a non empty Enumeration. If the filter object is not an instance of CurrentServiceFilter or 
RunningApplicationsFilter or one of their subclasses then, the method shall return an empty 
Enumeration. No IDs shall be returned for externally authorized applications, unless they are 
executing. This method will return an empty Enumeration if there are no matching applications. 

Parameters: 

filter - the filter to apply 

Returns: 

the applications available matching the filtering criteria 

Since: 

MHP1.0 



getAppProxy(AppID) 

public org . dvb . application .AppProxy getAppProxy (org. dvb . application .AppID key) 

Returns the ApplicationProxy associated with the given ID. Returns null if no such application 
available. 

Only one AppProxy object shall be returned in the case where there are several applications having 
the same (organisationid, applicationid) pair. In such a case, the same algorithm as would be used 
to autostart such applications shall be used to decide between the available choices by the 
implementation. 
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Parameters: 

key - an application ID. null if the key is not an application ID, or not mapped to any application 
available. 

Returns: 

the value to which the key is mapped in this dictionary; 

Throws: 

j ava . lang . SecurityException - shall not be thrown for ApplDs which are returned by 
getApplDs(CurrentServiceFilter) orgetApplDs(RunningApplicationsFilter) 

Since: 

MHP1.0 



getAppsDatabaseO 

public static org . dvb . application .AppsDatabase getAppsDatabase ( ) 

Returns the singleton AppsDatabase object. The AppsDatabase is either a singleton for each MHP 
application or a singleton for the MHP terminal. 

Returns: 

the singleton AppsDatabase object. 

Since: 

MHP1.0 

removeListener(AppsDatabaseEventListener) 

public void removeListener (org . dvb . application .AppsDatabaseEventListener listener) 

remove a listener on the database. 

Parameters: 

listener - the listener to be removed. 

Since: 

MHP1.0 

size() 

public int sizeO 

Returns the number of applications currently available. 

Returns: 

the number of applications currently available. 

Since: 

MHP1.0 
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org.dvb.application 

AppsDatabaseEvent 

Declaration 

public class AppsDatabaseEvent extends j ava . util .EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+--org . dvb . application .AppsDatabaseEvent 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The AppsDatabaseEvent class indicates either an entry in the application database has changed, or so many 
changes have occurred, that the database should be considered totally new. An event with event_id 
NEW_DATABASE shall always be sent after switching to a new service. After such an event, the contents of the 
database (both the set of applications and their attributes) shall reflect the new database contents. All former 
contents of the database shall be discarded except for running extenally authorised applications. It is platform 
dependant if and when a new database event is thrown while tuned to the same service except that a 
NEW_DATABASE event shall not be sent when only one application has changed within a service. 

The APP_ADDED, APP_CHANGED and APP_DELETED events shall not be generated in response to the same 
database change as caused a NEW_DATABASE event to be generated. 

Since: 

MHP1.0 



Fields 

APP_ADDED 

public static final int APP_ADDED 

The addition event id. Tine APP_ADDED event is generated winenever an entry is added to tine 
AppsDatabase. It is NOT generated winen tine entry already in the AppsDatabase changes. 

APP_CHANGED 

public static final int APP_CHANGED 

The changed event id. The APP_CHANGED event is generated whenever any of the information 
about an application changes. It is NOT generated when the entry is added to or removed from the 
AppsDatabase. In such cases, the APP_ADDED or APP_DELETED events will be generated 
instead. 
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APP_DELETED 

public static final int APP_DELETED 

The deletion event id. Tine APP_DELETED event is generated winenever an entry is removed from 
tine AppsDatabase. 

NEW_DATABASE 

public static final int NEW_DATABASE 

Tiie new database event id. 



Constructors 



AppsDatabaseEvent(int, AppID, Object) 

public AppsDatabaseEvent (int id, org . dvb . application .AppID appid, Java . lang. Object source) 

Create a new AppsDatabaseEvent object for tiie entry in tiie database tiiat ciianged, or for a new 
database. 

Parameters: 

id - tine cause of the event 



appid - tine AppId of tine entry tiiat cinanged 
source - tiie AppaDatabase object. 

Since: 

IVIHP1.0 

Methods 



getAppIDO 

public org . dvb . application .AppID getAppIDO 

gets tine application ID object for the entry in the database that changed. 
When the event type is NEW_DATABASE, AppID will be null. 

Returns: 

application ID representing the application 



Since: 

MHP1.0 



getEventldO 

public int getEventldO 

gets the type of the event. 

Returns: 

an integer that matches one of the static fields describing events. 



Since: 

MHP1.0 
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org.dvb.application 

AppsDatabaseEventListener 

Declaration 

public interface AppsDatabaseEventListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

The AppsDatabaseListener class allows an application to monitor the application database so that it can 
keep an up to date interface without polling the state. The application shall receive these events in a timely fashion 
after the AIT changes, however it is system dependant how often the AIT table is checked. 

Since: 

MHP1.0 



Methods 

entryAdded(AppsDatabaseEvent) 

public void entryAdded (org . dvb . application .AppsDatabaseEvent evt) 

The AppsDataBase has had an application entry added. 

Parameters: 

evt - the AppsDatabaseEvent. 

Since: 

IVIHP1.0 

entryChanged(AppsDatabaseEvent) 

public void entryChanged (org . dvb . application .AppsDatabaseEvent evt) 

The AppsDataBase has had an application entry changed. 

Parameters: 

evt - the AppsDatabaseEvent. 

Since: 

MHP1.0 

entryRemoved(AppsDatabaseEvent) 

public void entryRemoved (org . dvb . application .AppsDatabaseEvent evt) 

The AppsDataBase has had an application entry removed. 

Parameters: 

evt - the AppsDatabaseEvent. 

Since: 

MHP1.0 



ETSI 



666 ETSITS 101 812V1.3.1 (2003-06) 



newDatabase(AppsDatabaseEvent) 

public void newDatabase (org. dvb . application .AppsDatabaseEvent evt) 

The AppsDataBase has radically changed. 

Parameters: 

evt - the AppsDatabaseEvent. 



Since: 

MHP1.0 
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org.dvb.application 

AppsDatabaseFilter 

Declaration 

public abstract class AppsDatabaseFilter 
Java . lang .Object 

+ — org . dvb . application . AppsDatabaseFilter 

Direct Known Subclasses: 

Cur rentServiceFi Iter, RunningApplicat ions Filter 

Description 

Abstract class for the filters. Instances of concrete classes that extend AppsDatabaseFilter are passed to the 
AppsDatabase.getAppAttributes and AppsDatabase.getAppIDs methods to allow an applications to set a filter on 
the list of applications (respectively AppAttributes and AppIDs) that it wants to retrieve from the AppDatabase. 

Since: 

MHP 1.0 



Constructors 

AppsDatabaseFUterQ 

public AppsDatabaseFilter ( ) 

Construct an AppsDatabaseFilter object. 

Methods 



accept(AppID) 

public abstract boolean accept (org. dvb . application .AppID appid) 

Test if a specified appid sinould be included in the Enumeration. 

Parameters: 

appid - the specified appid to test. 

Returns: 

true if the application with identifier appid should be listed, false otherwise. 

Since: 

MHP1.0 
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org.dvb.application 

AppStateChangeEvent 

Declaration 

public class AppStateChangeEvent extends j ava . util . EventObject 

Java . lang .Object 

+ — j ava . util . EventObject 
I 
+--org . dvb . application .AppStateChangeEvent 

All Implemented Interfaces: 

j ava .io.Serializable 

Description 

The AppStateChangeEvent class indicates a state transition of the application. These events are only 
generated for running applications or formerly running applications on completion of a state transition into the 
DESTROYED state. If the state transition was requested by an application through this API, the method 
hasFailed indicates whether the state change failed or not. Where a state change succeeds, f romState and 
toState shall indicate the original and destination state of the transition. If it failed, f romState shall return the 
state the application was in before the state transition was requested and the toState method shall return the state 
the application would have been in if the state transition had succeeded. 

Attempting to start an application which is already running shall fail and generate an AppStateChangeEvent 
with hasFailed returning true and both fromstate and tostate being STARTED. 

Since: 

MHP1.0 



Constructors 



AppStateChangeEvent(AppID, int, int, Object, boolean) 

public AppStateChangeEvent (org. dvb. application .AppID appid, int fromstate, int tostate, 
j ava . lang .Object source, boolean hasFailed) 

Create an AppStateChangeEvent object. 

Parameters: 

appid - a registry entry representing ihe tracl<ed application 

fromstate - tine state tine application was in before the state transition was requested, where 
the value of fromState is one of the state values defined in the AppProxy interface or in the 
interfaces inheriting from it 

tostate - state the application would be in if the state transition succeeds, where the value of 
toState is one of the state values defined in the AppProxy interface or in the interfaces inheriting 
from it 

hasFailed - an indication of whether the transition failed (true) or succeeded (false) 

source - the AppProxy where the state transition happened 
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Methods 



getAppIDO 

public org. dvb. application. AppID getAppIDO 

The application tine listener was tracking has made a state transition from fromstate to toState. 

Returns: 

a registry entry representing the tracked application 



Since: 

MHP1.0 



getFromStateO 

public int getFromStateO 

The application the listener is tracking was inf romState, where the value of fromState is one of the 
state values defined in the AppProxy interface or in the interfaces inheriting from it. 

Returns: 

the old state 

Since: 

MHP1.0 



getToStateO 

public int getToStateO 

If the hasFailed method returns false, then the application the listener is tracking is now in 
toState. If the hasFailed method returns true, then the toState is the state where the state 
transition was attempted to but the transition failed. The value of toState is one of the state values 
defined in the AppProxy interface or in the interfaces inheriting from it. 

Returns: 

the intended or actual new state 

Since: 

MHP1.0 



hasFailedQ 

public boolean hasFailed () 

This method determines whether an attempt to change the state of an application has failed. 

Returns: 

true if the attempt to change the state of the application failed, false otherwise 

Since: 

MHP1.0 
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org.dvb.application 

AppStateChangeEventListener 

Declaration 

public interface AppStateChangeEventListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

The AppStateChangeEventListener class allows a launcher application to keep track of applications it 
launches or other applications running as part of the same service. 

Since: 

MHP1.0 



Methods 

stateChange(AppStateChangeEvent) 

public void stateChange (org. dvb . application .AppStateChangeEvent evt) 

The application tine listener was tracking has made a state transition from f romState to toState 
and this method will be given the state event. 

Parameters: 

evt - the AppStateChangeEvent. 

Since: 

MHP1.0 
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org.dvb.application 

CurrentServiceFilter 



Declaration 

public class CurrentServiceFilter extends AppsDatabaseFilter 

Java . lang .Object 

H org . dvb . application .AppsDatabaseFilter 

I 

+--org . dvb . application . CurrentServiceFilter 

Description 

Instances of CurrentServiceFilter are used to set a filter on the list of applications that are retrieved from 
the AppsDatabase (See methods getAppsAttributes and getAppsIDs). 

A CurrentServiceFilter is used to indicate that only applications that signalled as part of the current 
service shall be returned by the getAppsAttributes and getAppIDs methods of AppsDatabase. Externally authorized 
applications in the AIT are not considered to be signalled as part of the current service for this filter. If an 
application signalled as part of the current service has an application instance in the destroyed state then 
information on that appplication instance shall not be retrieved. Instead, what shall be retrieved is information on 
another application instance which would normally be in the not loaded state. Subclasses of CurrentServiceFilter 
can override the accept method so as to implement their own filter criteria on the AppID's values. 

Since: 

MHP 1.0 



Constructors 

CurrentServiceFilterO 

public CurrentServiceFilter ( ) 

public Constructor of the CurrentServiceFilter 

Methods 



accept(AppID) 

public boolean accept (org . dvb . application .AppID appid) 

Test if a specified appid should be included in the Enumeration. 

Overrides: 

accept in class AppsDatabaseFilter 

Parameters: 

appid - the specified appid to test. 

Returns: 

true if the application with identifier appid should be listed, false otherwise. 

Since: 

MHP1.0 
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org.dvb.application 

DVBHTMLProxy 



Declaration 

public interface DVBHTMLProxy extends AppProxy 

All Superinterfaces: 

AppProxy 

Description 

A DVBHTMLProxy Object is a proxy to a DVBHTML application. 



Fields 



KILLED 

public static final int KILLED 

The application is in tine l<illed state. 

Since: 

IVIHP 1.0.2 



LOADING 

public static final int LOADING 

The application is in the loading state. 

Since: 

MHP 1.0.2 



Methods 



prefetcliO 

public void prefetch () 

Loads the initial entry page of the application and waits for a signal. This method mimics the 
PREFETCH control code and is intended to be called instead of and not as well as start. Calling 
prefetch on a started application will have no effect. 

Throws: 

j ava . lang . SecurityException - if the calling application does not have permission to start 
applications 

Since: 

MHP1.0 
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Start Trigger(Date) 

public void startTrigger ( j ava . util . Date starttime) 

Sends the application a start trigger at ihe specified time. 

Parameters: 

starttime - tine specified time to send a start trigger to tine application. If the time has already 
passed the application manager shall send the trigger immediately. Dates pre-epoch shall 
always cause the application manager to send the trigger immediately. 

Throws: 

Java. lang. SecurityException - if the calling application does not have permission to start 
applications 

Since: 

MHP1.0 



trigger(Date, Object) 

public void trigger (Java . util . Date time, j ava . lang .Object triggerPayload) 

Sends the application a trigger with the given payload at the specified time. 

Parameters: 

time - the specified time to send a start trigger to the application. If the time has already passed 
the application manager should send the trigger immediately. Dates pre-epoch shall always 
cause the application manager to send a 'now' trigger. 

triggerPayload - the specified payload to deliver with the trigger. The payload is specified as 
object, but this will be refined once DVB-HTML Triggers are properly defined. 

Throws: 

j ava . lang . SecurityException - if the calling application does not have permission to start 
applications 

Since: 

MHP1.0 
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org.dvb.application 

DVB J Proxy 



Declaration 

public interface DVBJProxy extends AppProxy 

All Superinterfaces: 

AppProxy 

Description 

A DVBJProxy Object is a proxy to a DVBJ application. 



Fields 



LOADED 

public static final int LOADED 

The application is in tine loaded state. 



Methods 



initO 

public void init ( ) 

Requests the application manager calls the initxiet method on the application. 

This method is asynchronous and its completion will be notified by an AppStateChangedEvent. In 
case of failure, the hasFailed method of the AppStateChangedEvent will return true. Calls to this 
method shall only succeed if the application is in the NOT_LOADED or LOADED states. If the 
application is in the NOT_LOADED state, the application will move through the LOADED state into 
the PAUSED state before calls to this method complete. 

In all cases, an AppStateChangeEvent will be sent, whether the call was successful or not. 

Throws: 

j ava . lang . SecurityException - if the application is not entitled to load this application. 
Being able to init an application requires to be entitled to start it. 

Since: 

MHP1.0 
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loadO 

public void load ( ) 

Provides a hint to preload at least the initial class of the application into local storage, resources 
permitting. This does not require loading of classes into the virtual machine or creation of a new 
logical virtual machine which are implications of the init method. 

This method is asynchronous and its completion will be notified by an AppStateChangedEvent. In 
case of failure, the hasFaiied method of the AppStateChangedEvent will return true. Calls to 
this method shall only succeed if the application is in the NOT_LOADED state. In all cases, an 
AppStateChangeEvent will be sent, whether the call was successful or not. 

Throws: 

j ava . lang . SecurityException - if the application is not entitled to load this application. 
Being able to load an application requires to be entitled to start it. 

Since: 

MHP1.0 
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org.dvb.application 

lllegalProfileParameterException 

Declaration 

public class IllegalProf ileParameterException extends Java . lang. Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . dvb . application . IllegalProf ileParameterException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The IllegalProf ileParameter exception is thrown if the application attempts to ask for a version number 
for a profile not specified for the application. 

Since: 

MHP1.0 



Constructors 

IllegalProfileParameterExceptionO 

public IllegalProfileParameterException ( ) 

Construct a lllegalProfileParameterException with no detail message 
IllegalProfileParameterException(String) 

public IllegalProf ileParameterException (Java . lang . String s) 

Construct a lllegalProfileParameterException witin a detail message 

Parameters: 

s - detail message 
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org.dvb.application 

LanguageNotAvailableException 



Declaration 

public class LanguageNotAvailableException extends Java . lang .Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . dvb . application . LanguageNotAvailableException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The LanguageNotAvailableException exception is thrown if the application asks for the name of an 
application in a language not signalled in the AIT. 

Since: 

MHP1.0 



Constructors 

LanguageNotAvailableExceptionO 

public LanguageNotAvailableException () 

Construct a LanguageNotAvailableException with no detail message 
LanguageNotAvailableException(String) 

public LanguageNotAvailableException (j ava . lang . String s) 

Construct a LanguageNotAvailableException with a detail message 

Parameters: 

s - detail message 
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org.dvb.application 

RunningApplicationsFilter 

Declaration 

public class RunningApplicationsFilter extends AppsDatabaseFilter 

Java . lang .Object 

H org . dvb . application .AppsDatabaseFilter 

I 

+--org . dvb . application . RunningApplicationsFilter 

Description 

Instances of Ru n n i n g App 1 i c a t i o n s F i 1 1 e r are used to set a filter on the list of applications that are retrieved 
from the AppsDatabase (See methods getAppsAttributes and getAppsIDs). 

A RunningApplicationsFilter is used to indicate that only applications that are running as part of the 
current service shall be returned by the getAppsAttributes and getAppIDs methods of AppsDatabase. Externally 
authorized applications in the AIT shall be returned if they are currently running in the same service context as the 
caller. Subclasses of RunningApplicationsFilter can override the accept method so as to implement their own filter 
criteria on the AppID's values. 

Since: 

MHP 1.0 



Constructors 

RunningApplicationsFilterO 

public RunningApplicationsFilter () 

public Constructor of the RunningApplicationsFilter 

Methods 



accept(AppID) 

public boolean accept (org . dvb . application .AppID appid) 

Test if a specified appid should be included in the Enumeration. 

Overrides: 

accept in class AppsDatabaseFilter 

Parameters: 

appid - the specified appid to test. 

Returns: 

true if the application with identifier appid should be listed, false otherwise. 

Since: 

MHP1.0 
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Annex T (normative): Permissions 
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Package 

org.dvb.net.ca 



Description 

Provides extensions to the conditional access API from DAVIC. 



Class Summary 



Classes 

CAPermission jhis class is for CA permissions. 
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org.dvb.net.ca 

CAPermission 



Declaration 

public class CAPermission extends j ava . security . BasicPermission 

Java . lang .Object 

H j ava . security. Permission 

I 

-I Java .security. BasicPermission 

+ — org.dvb .net . ca. CAPermission 

All Implemented Interfaces: 

j ava .security. Guard, j ava .io.Serializable 

Description 

This class is for CA permissions. A CAPermission contains a name, but no actions list. 

A CAPermission contains a range of CA system ids and a specific permission for that range of CA system ids. 
Instead of a range of CA system ids, the CAPermission can also refer to a single CA system id. 

The name has the following syntax: 

CASystemldRange ":" Permission 

where CASystemldRange = CASystemId [ "-" CASystemId ] I "*" 
and Permission = "MMI" I "buy" I "entitlementlnfo" I "messagePassing" I "*" 

Examples: 

• 0xl200-0xl20A:buy (The permission to buy entitlement for all the CA systems with ids between 0x1200 and 
0xl20A inclusive.) 

• 0x1201 : entitlementlnfo (The permission to get entitlement information for the CA system with id 0x1201) 

• 0xl20d:* (This wildcard expresses all the permissions for the CA system with id 0xl20d). 
Note: The CASystemId is expressed as a hexadecimal value. 

The permission "MMI" corresponds with the SecurityException on CAModuleManager.addMMIListener(). The 
permission "buy" corresponds with the SecurityException on CAModule.buyEntitlement(). The permission 
"entitlementlnfo" corresponds with the SecurityException on CAModule.queryEntitlement() and 
CAModule.listEntitlements(). The permission "messagePassing" corresponds with 
CAModule.openMessageSession(MessageListener) 



Constructors 



CAPermission(String) 

public CAPermission (Java . lang . String name) 

Creates a new CAPermission witii tiie specified name. Tine name is tine symbolic name of the 
CAPermission. 

Parameters: 

name - tiie name of tiie CAPermission 
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CAPermission(String, String) 

public CAPermission (Java . lang . String name, j ava . lang . String actions) 

Creates a new CAPermission object witin tine specified name. Tine name is tine symbolic name of tine 
CAPermission, and tine actions String is unused and sinould be null. This constructor exists for use 
by the Policy object to instantiate new Permission objects. 



Parameters: 

name - the name of the CAPermission 

actions - should be null. 



Methods 



implies(Permission) 

public boolean implies (Java . security . Permission p) 

Checks if the specified permission is "implied" by this object. 

Overrides: 

implies in class BasicPermission 

Parameters: 

p - the permission to check against. 

Returns: 

true if the passed permission is equal to or implied by this permission, false otherwise. 
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Package 

org.dvb.net.tuning 



Description 

Provides extensions to the tuning API from DAVIC. 



Class Summary 



Classes 

DvbNetworkinterf ace- Each SI database is associated witli a network interface and vice versa. 

SlUtil 

TunerPermission jhjs class is for tuner permissions. 
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org. dvb.net. tuning 

DvbNetworklnterfaceSIUtil 



Declaration 

public class DvbNetworklnterfaceSIUtil 
Java . lang .Object 

+ — org.dvb .net .tuning. DvbNetworklnterfaceSIUtil 

Description 

Each SI database is associated with a network interface and vice versa. This class allows the application to query 
this association. 

Since: 

MHP 1.0.1 



Methods 



getNetworklnterface(SIDatabase) 

public static org . davic . net . tuning .Networklnter face 

getNetworklnterface (org . dvb . si . SIDatabase sd) 

Gets the network interface for a particular SI database. 

Parameters: 

sd - the SI database for which the associated network interface will be returned. 

Returns: 

the associated network interface 



getSIDatabase(Networklnterface) 

public static org . dvb . si . SIDatabase getSIDatabase (org . davic . net . tuning .Networklnterf ace ni) 

Gets the SI database for a particular network interface. 

Parameters: 

ni - the network interface for which the associated SI database will be returned. 

Returns: 

the associated SI database 
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org. dvb.net. tuning 

TunerPermission 



Declaration 

public class TunerPermission extends j ava . security . BasicPermission 

Java . lang .Object 

H j ava . security. Permission 

I 

-I Java .security. BasicPermission 

+ — org.dvb .net .tuning. TunerPermission 

All Implemented Interfaces: 

j ava .security. Guard, j ava .io.Serializable 

Description 

This class is for tuner permissions. A TunerPermission contains no name and no actions list. If an application has 
the tuner permission, then it shall not receive a SecurityException from those methods in that API defined to 
throw one. Without such a permission, it shall receive such an exception. 



Constructors 

TunerPermission(String) 

public TunerPermission (j ava . lang . String name) 

Creates a new TunerPermission. The name string is currently unused and sinould be empty. 

Parameters: 

name - tine name of tine TunerPermission. 

TunerPermission(String, String) 

public TunerPermission (Java . lang . String name, j ava . lang. String actions) 

Creates a new TunerPermission. Tiie name string is currently unused and should be empty. The 
actions string is currently unused and should be null. This constructor exists for use by the Policy 
object to instantiate new Permission objects. 

Parameters: 

name - the name of the TunerPermission. 

actions - the actions list 
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Methods 



implies(Permission) 

public boolean implies (Java . security . Permission p) 

Checks if the specified permission is "implied" by this object. 

Since name and actions aren't used, the only check needed is whether p is also a TunerPermission. 

Overrides: 

implies in class BasicPermission 

Parameters: 

p - the permission to check against. 

Returns: 

true if the passed permission is equal to or implied by this permission, false otherwise. 
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Annex U (normative): Extended graphics APIs 
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Package 

org.dvb.ui 



Description 

Provides extended graphics functionality. 



Class Summary 



Interfaces 

TestOpacity 

TextOverf lowListener 

Classes 

DVBAlphaComposite 

DVBBuf f eredlmage 

DVBColor 
DVBGraphics 

DVBTextLayoutManager 
FontFactory 



Exceptions 

DVBRaster Forma tExcep- 
tion 

FontFormatException 



FontNotAvailableEx- 
ception 

Un support edDrawingOp - 
erationException 



Interface implemented by Components or Containers in order to allow the plat- 
form to query whether their paint method is fully opaque. 

The TextOverflowListener is an interface that an application may implement 
and register in the DVBTextLayoutManager. 



This DVBAlphaComposite class Implements the basic alpha compositing 
rules for combining source and destination pixels to achieve blending and 
transparency effects with graphics, images and video. 

The DVBBuf f eredlmage subclass describes an j ava . awt . Image with an 
accessible buffer of image data. 

A Color class which adds the notion of alpha. 

The DVBGraphics class is a adapter class to support alpha compositing in 
an MHP device. 

The DVBTextLayoutManager provides a text rendering layout mechanism for 
the org.havi.ui.HStaticText org.havi.ui.HText and org.havi.ui.HTextButton 
classes. 

Provides a mechanism for applications to instantiate fonts that are not built into 
the system. 



This exception is thrown for some invalid operations on instances of 

DVBBuf f eredlmage. 

Thrown when attempt is made to read a file describing a font when the con- 
tents of that file are not valid. 

Thrown when attempt is made to instantiate a font that cannot be located. 

The UnsupportedDrawingOperationException class represents an 
exception that is thrown if an drawing operation is not supported on this plat- 
form. 
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org.dvb.ui 

DVBAIphaComposite 

Declaration 

public final class DVBAIphaComposite 
Java . lang .Object 

+ — org . dvb . ui . DVBAIphaComposite 

Description 

This DVBAIphaComposite class implements the basic alpha compositing rules for combining source and 
destination pixels to achieve blending and transparency effects with graphics, images and video. The rules 
implemented by this class are a subset of the Porter-Duff rules described in T Porter and T. Duff, "Compositing 
Digital Images", SIGGRAPH 84, 253-259. 

If any input does not have an alpha channel, an alpha value of 1 .0, which is completely opaque, is assumed for all 
pixels. A constant alpha value can also be specified to be multiplied with the alpha value of the source pixels. 

The following abbreviations are used in the description of the rules: 

• Cs = one of the color components of the source pixel without alpha. 

• cs = color component of a source pixel premultimlied with alpha (cs = As*Ar*Cs) 

• Cd = one of the color components of the destination pixel without alpha. 

• cd = color component of a destination pixel premultimlied with alpha 

• Cn = the new constructed color without alpha. 

• en = the new constructed color premultiplied with alpha 

• As = alpha component of the source pixel. 

• Ad = alpha component of the destination pixel. 

• An = the new alpha after compositing 

• Ar = alpha, specified by getlnstance(int Rule, float Ar). Unless otherwise specified Ar = l.Of 

• Fs = fraction of the source pixel that contributes to the output. 

• Fd = fraction of the input destination pixel that contributes to the output. 

The color and alpha components produced by the compositing operation are calculated as follows: 

cn = (As*Ar) *Cs*Fs + Ad*Cd*Fd 
An = (As*Ar) *Fs + Ad*Fd 
Cn = en/An 

where Fs and Fd are specified by each rule. 

The alpha resulting from the compositing operation is stored in the destination if the destination has an alpha 
channel. Otherwise, the resulting color is divided by the resulting alpha before being stored in the destination and 
the alpha is discarded. If the alpha value is 0.0, the color values are set to 0.0. 

See Also: 

j ava . awt . AlphaComposite 



Fields 
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Clear 

public static final org. dvb . ui . DVBAlphaComposite Clear 

DVBAlphaComposite object that implements the opaque CLEAR rule with an alpha (Ar) of I.Of. 
See Also: 



CLEAR 



CLEAR 

public static final int CLEAR 

Porter-Duff Clear rule. Both the color and the alpha of the destination are cleared. Neither the source 
nor the destination is used as input. 

Fs = and Fd = 0, thus: 

en = 
An = 
Cn = 

Note that this operation is a fast drawing operation This operation is the same as using a source 
with alpha= and the SRC rule 



DST_IN 

public static final int DST_IN 

Porter-Duff Destination In Source rule. The part of the destination lying inside of the source replaces 
the destination. 

Fs = and Fd = (As*Ar), thus: 

cn = Ad*Cd* (As*Ar) 
An = Ad* (As*Ar) 
Cn = Cd 

Note that this operation is faster than e.g. SRC_OVER but slower than SRC 



DST_OUT 

public static final int DST_OUT 

Porter-Duff Destination Held Out By Source rule. The part of the destination lying outside of the 



source replaces the destination. 
Fs = and Fd = (1-(As*Ar)), thus: 

cn = Ad*Cd* (1- (As*Ar) ) 
An = Ad* (1- (As*Ar) ) 
Cn = Cd 

Note that this operation is faster than e.g. SRC_OVER but slower than SRC 
DST_OVER 

public static final int DST_OVER 

Porter-Duff Destination Over Source rule. The destination is composited over the source and the 
result replaces the destination. 

Fs = (1-Ad)and Fd = 1,thus: 

cn = (As*Ar) *Cs* (1-Ad) + Ad*Cd 
An = (As*Ar) * (1-Ad) + Ad 

Note that this can be a very slow drawing operation 
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Dstin 

public static final org. dvb . ui . DVBAlphaComposite DstIn 

DVBAlphaComposite object that implements the opaque DST_IN rule with an alpha (Ar) of I.Of. 
See Also: 



DST IN 



DstOut 

public static final org. dvb . ui . DVBAlphaComposite DstOut 

DVBAlphaComposite object that implements the opaque DST_OUT rule with an alpha (Ar) of 1 .Of. 
See Also: 



DST OUT 



DstOver 

public static final org. dvb . ui . DVBAlphaComposite DstOver 

DVBAlphaComposite object that implements the opaque DST_OVER rule with an alpha (Ar) of 
I.Of. 

See Also: 

DST OVER 



Src 

public static final org. dvb . ui . DVBAlphaComposite Src 

DVBAlphaComposite object that implements the opaque SRC rule with an alpha (Ar) of 1 .Of. 

See Also: 

SRC 

SRC 

public static final int SRC 

Porter-Duff Source rule. The source is copied to the destination. The destination is not used as input. 
Fs = 1 and Fd = 0, thus: 

en = (As*Ar) *Cs 
An = As*Ar 
Cn = Cs 

Note that this is a fast drawing routine 
SRC_IN 

public static final int SRC_IN 

Porter-Duff Source In Destination rule. The part of the source lying inside of the destination replaces 
the destination. 

Fs = Ad and Fd = 0, thus: 

cn = (As*Ar) *Cs*Ad 
An = (As*Ar) *Ad 
Cn = Cs 

Note that this operation is faster than e.g. SRC_OVER but slower then SRC 
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SRC_OUT 

public static final int SRC_OUT 

Porter-Duff Source Held Out By Destination rule. The part of the source lying outside of the 



destination replaces the destination. 
Fs = (1-Ad)and Fd = 0, thus: 



en = (As*Ar) *Cs* (1-Ad) 
An = (As*Ar) * (1-Ad) 
Cn = Cs 

Note that this operation is faster than e.g. SRC_OVER but slower than SRC 



SRC_OVER 

public static final int SRC_OVER 

Porter-Duff Source Over Destination rule. The source is composited over the destination. 
Fs = 1 and Fd = (1-(As*Ar)), thus: 



cn = (As*Ar)*Cs + Ad*Cd* (1- (As*Ar) ) 
An = (As*Ar) + Ad* (1- (As*Ar ) ) 

Note that this can be a very slow drawing operation 



Srcin 

public static final org. dvb . ui . DVBAlphaComposite SrcIn 

DVBAlphaComposite object that implements the opaque SRC_IN rule with an alpha (Ar) of 1 .Of. 
See Also: 



SRC IN 



SrcOut 

public static final org. dvb .ui . DVBAlphaComposite SrcOut 

DVBAlphaComposite object that implements the opaque SRC_OUT rule with an alpha (Ar) of 1 .Of. 
See Also: 



SRC OUT 



SrcOver 

public static final org. dvb . ui . DVBAlphaComposite SrcOver 

DVBAlphaComposite object that implements the opaque SRC_OVER rule with an alpha (Ar) of 
1.0f. 

See Also: 

SRC OVER 
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Methods 



equals(Object) 

public boolean equals {j ava . lang. Object obj) 

Tests if the specified java. lang. object is equal to tinis DVBAiphaComposite object. 

Overrides: 

equals in class Obj ect 

Parameters: 

obj - tine Obj ect to test for equality 

Returns: 

true if obj is a DVBAiphaComposite and has the same values for rule and alpha as this object. 



Otherwise false shall be returned. 



getAlphaO 

public float getAlphaO 

Returns the alpha value of this DVBAiphaComposite. If this DVBAiphaComposite does not have 



an alpha value, 1 .0 is returned. 

Returns: 

the alpha value of this DVBAiphaComposite. 



getlnstance(int) 

public static org . dvb . ui . DVBAiphaComposite getlnstance (int rule) 

Creates an DVBAiphaComposite object with the specified rule. The value for alpha shall be 1 .Of. 

Parameters: 

rule - the compositing rule 

Returns: 

an DVBAiphaComposite object with the specified rule. 

getlnstance(int, float) 

public static org . dvb . ui . DVBAiphaComposite getlnstance (int rule, float alpha) 

Creates an DVBAiphaComposite object with the specified rule and the constant alpha (Ar) to 
multiply with the alpha of the source (As). The source is multiplied with the specified alpha before 
being composited with the destination. 

Parameters: 

rule - the compositing rule 

alpha - the constant alpha (Ar) to be multiplied with the alpha of the source (As), alpha must 
be a floating point number in the inclusive range [0.0, 1 .0]. 

Returns: 

an DVBAiphaComposite object with the specified rule and the constant alpha to multiply with 
the alpha of the source. 
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getRuleO 

public int getRuleO 

Returns the compositing rule of tiiis DVBAlphaComposite. 

Returns: 

the compositing rule of this DVBAlphaComposite. 
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org.dvb.ui 

DVBBufferedlnnage 

Declaration 

public class DVBBuf feredlmage extends j ava . awt . Image 

Java . lang .Object 

H j ava . awt . Image 

I 

+--org . dvb . ui . DVBBuf feredlmage 

Description 

The DVBBuf feredlmage subclass describes an j ava . awt . Image with an accessible buffer of image data. 
The DVB Buff eredlmage is an adapter class for Java. awt.image.Bufferedlmage. It supports two different platform 
dependent sample models TYPE_BASE and TYPE_ ADVANCED. Buffered images with the TYPE_BASE have 
the same sample model as the on screen graphics buffer, thus TYPE_BASE could be CLUT based. 
TYPE_ADVANCED has a direct color model but it is not specified how many bits are used to store the different 
color components. By default, a new DVBBufferedlmage is transparent. All alpha values are set to 0; Instances of 
DVBBufferedlmage shall be considered to be off-screen images for the purpose of the inherited method 
Image . getGraphics. 

Since: 

MHP 1.0 



Fields 



TYPE_ADVANCED 

public static final int TYPE_ADVANCED 

Represents an image stored in a best possible SamplelVlodel (platform dependent) The image has a 
DirectColorModel with alpha. The color data in this image is considered not to be premultiplied with 
alpha. The data returned by getRGBQ will be in the TYPE_INT_ARGB color model that is alpha 
component in bits 24-31 , the red component in bits 16-23, the green component in bits 8-15, and the 
blue component in bits 0-7. The data for setRGBQ shall be in the TYPE_INT_ARGB color model as 
well. 

Since: 

MHP 1.0 

TYPE_BASE 

public static final int TYPE_BASE 

Represents an image stored in a platform dependent Sample Model. This color model is not visible 
to applications. The data returned by getRGB() will be in the TYPE_INT_ARGB color model that is 
alpha component in bits 24-31, the red component in bits 16-23, the green component in bits 8-15, 
and the blue component in bits 0-7. The data for setRGBQ shall be in the TYPE_INT_ARGB color 
model as well. 

Since: 

MHP 1.0 
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Constructors 



DVBBufferedImage(int, int) 

public DVBBuf feredlmage (int width, int height) 

Constructs a DVBBufferedlmage with the specified width and height. The Sample IVIodel used the 
image is the native Sample Model (TYPE_BASE) of the implementation. Note that a request can 
lead to an java.lang.OutOfMemoryError. Applications should be aware of this. 

Parameters: 

width - the width of the created image 

height - the height of the created image 

Since: 

MHP 1.0 

DVBBufferedImage(int, int, int) 

public DVBBuf feredlmage (int width, int height, int type) 

Constructs a new DVBBufferedlmage with the specified width and height in the Sample Model 
specified by type. Note that a request can lead to an java.lang.OutOfMemoryError. Applications 
should be aware of this. 

Parameters: 

width - the width of the DVBBufferedlmage 

height - the height of the DVBBufferedlmage 
type - the ColorSpace of the DVBBufferedlmage 

Since: 

MHP 1.0 



Methods 



createGrapliicsO 

public org.dvb.ui . DVBGraphics createGraphics ( ) 

Creates a DVBGraphics, which can be used to draw into this DVBBufferedlmage. Calls to this 
method after calls to the dispose method on the same instance shall return null. 

Returns: 

a DVBGraphics, used for drawing into this image. 

Since: 

MHP 1.0 



ETSI 



697 ETSITS 101 812V1.3.1 (2003-06) 



disposeO 

public void disposeO 

Disposes of this buffered image. Tinis metlnod releases tiie resources (e.g. pixel memory) underlying 
this buffered image. After calling this method ; 

• the image concerned may not be used again 

• the image shall be considered to have a width and height of -1, -1 as specified for instances of 
java.awt.Image where the width and height are not yet known. 

• the getGraphics method may return null 

Since: 

MHP 1.0.1 



flushQ 

public void f lush ( ) 

Flushes all resources being used to cache optimization information. The underlying pixel data is 
unaffected. Calls to this method after calls to the dispose method on the same instance shall fail 
silently. 

Overrides: 

flush in class image 

getGraphicsQ 

public Java. awt. Graphics getGraphics ( ) 

This method returns a j ava. awt .Graphics , it is here for backwards compatibility. 
createGraphics is more convenient, since it is declared to return a DVBGraphics. Calls to this 
method after calls to the dispose method on the same instance shall return null. 

Overrides: 

getGraphics in class Image 

Returns: 

a Graphics, which can be used to draw into this image. 

getHeightO 

public int getHeightO 

Returns the height of the DVBBuf f eredlmage. 

Returns: 

the height of this DVBBuff eredlmage. 

Since: 

MHP 1.0 



getHeight(ImageObserver) 

public int getHeight (Java . awt . image . ImageObserver observer) 

Returns the height of the image. If the height is not known yet then the ImageObserver is notified 
later and -l is returned. 

Overrides: 

getHeight in class Image 
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Parameters: 

observer - the imageObserver that receives information about the image 

Returns: 

the height of the image or -i if the height is not yet l<nown. 

See Also: 

j ava . awt . Image . getWidth { ImageObserver) , j ava . awt . image . ImageObserver 

getlmageO 

public j ava . awt . Image getlmageO 

Returns a Java. awt. Image representing this buffered image. In implementations which implement 
java.awt.image.Bufferedlmage this returns a java.awt.image.Bufferedlmage cast to a 
java.awt.lmage. Otherwise it is implementation dependent whether it returns this image or whether it 
returns an instance of an underlying platform specific sub-class of java.awt.lmage. Calls to this 
method after calls to the dispose method on the same instance shall return null. 

Returns: 

a java.awt.lmage representing this buffered image 

Since: 

MHP 1.0 



getProperty(String, ImageObserver) 

public Java . lang.Obj ect getProperty (Java . lang . String name, 
j ava . awt . image . ImageObserver observer) 

Returns a property of the image by name. Individual property names are defined by the various 
image formats. If a property is not defined for a particular image, this method returns the 
Undef inedProperty field. If the properties for this image are not yet known, then this method 
returns null and the ImageObserver object is notified later. The property name "comment" should 
be used to store an optional comment that can be presented to the user as a description of the 
image, its source, or its author. Calls to this method after calls to the dispose method on the same 
instance shall return null. 

Overrides: 

getProperty in class Image 

Parameters: 

name - the property name 

observer - the ImageObserver that receives notification regarding image information 

Returns: 

an Java. lang. Object that is the property referred to by the specified name or null if the 
properties of this image are not yet known. 

See Also: 

j ava . awt . image . ImageObserver, j ava . awt . Image . Undef inedProperty 



getRGB(int, int) 

public int getRGB(int x, int y) 

Returns the specified integer pixel in the default RGB color model (TYPE_INT_ARGB) and default 
sRGB colorspace. Color conversion takes place if the used Sample Model is not 8-bit for each color 
component There are only 8-bits of precision for each color component in the returned data when 
using this method. Note that when a lower precision is used in this buffered image getRGB may 
return different values than those used in setRGB() 
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Parameters: 

X - the x-coordinate of the pixel 

y - the y-coordinate of the pixel 

Returns: 

an integer pixel in the default RGB color model (TYPE_INT_ARGB) and default sRGB 
colorspace. 

Throws: 

ArraylndexOutOfBoundsException - if x or y is out of bounds or if the dispose method has been 
called on this instance 

Since: 

MHP 1.0 



getRGB(int, int, int, int, int[], int, int) 

public int [ ] getRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, 
int scansize) 

Returns an array of integer pixels in the default RGB color model (TYPE_INT_ARGB) and default 
sRGB color space, from a rectangular region of the image data. There are only 8-bits of precision for 
each color component in the returned data when using this method. With a specified coordinate (x, 
y) in the image, the ARGB pixel can be accessed in this way: 

pixel = rgbArray [of f set + (y-startY) *scansize + (x-startX) ] ; 

Parameters: 

StartX - the x-coordinate of the upper-left corner of the specified rectangular region 

StartY - the y-coordinate of the upper-left corner of the specified rectangular region 
w - the width of the specified rectangular region 
h - the height of the specified rectangular region 
rgbArray - if not null, the rgb pixels are written here 

offset - offset into the rgbArray 
scansize - scanline stride for the rgbArray 

Returns: 

array of ARGB pixels. 

Throws: 

ArraylndexOutOfBoundsException - if the specified portion of the image data is out of bounds or 
if the dispose method has been called on this instance 

Since: 

MHP 1.0 



getScaledInstance(int, int, int) 

public j ava . awt . Image getScaledlnstance (int width, int height, int hints) 

Creates a scaled version of this image. A new image object is returned which will render the image 
at the specified width and height by default. The new image object may be loaded 
asynchronously even if the original source image has already been loaded completely. If either the 
width or height is a negative number then a value is substituted to maintain the aspect ratio of the 
original image dimensions. If the dispose method has been called on this instance than null shall 
be returned. 
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Overrides: 

getScaledlnstance in class Image 

Parameters: 

width - the width to which to scale the image. 

height - the height to which to scale the image. 

hints - flags to indicate the type of algorithm to use for image resampling. 

Returns: 

a scaled version of the image. 

getSourceO 

public Java . awt . image . ImageProducer getSource ( ) 

Returns the object that produces the pixels for the image. 

Overrides: 

getSource in class Image 

Returns: 

the j ava . awt . image . ImageProducer that is used to produce the pixels for this image. 

If the dispose method has been called on this instance than null shall be returned. The source 
returned by this method is platform generated to provide access to the current contents of the 

DVBBuf feredlmage buffer. 

See Also: 

j ava . awt . image . ImageProducer 



getSubimage(int, int, int, int) 

public org . dvb . ui . DVBBuf feredlmage getSubimage (int x, int y, int w, int h) 
throws DVBRasterFormatException 

Returns a subimage defined by a specified rectangular region. The returned DVBBuf feredlmage 
shares the same data array as the original image. If the dispose method has been called on this 
instance than null shall be returned. 

Parameters: 

X - the x-coordinate of the upper-left corner of the specified rectangular region 

y - the y-coordinate of the upper-left corner of the specified rectangular region 
w - the width of the specified rectangular region 
h - the height of the specified rectangular region 

Returns: 

a DVBBuf feredlmage that is the subimage of this DVBBuf feredlmage. 

Throws: 

DVBRasterFormatException - if the specified area is not contained within this 

DVBBuf feredlmage. 

Since: 

MHP 1.0 



getWidthO 

public int getWidth () 

Returns the width of the DVBBuf feredlmage. 
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Returns: 

the width of this DVBBuf f eredlmage. 

Since: 

IVIHP 1.0 



getWidth(ImageObserver) 

public int getWidth (Java . awt . image . ImageObserver observer) 

Returns the width of the image. If the width is not l<nown yet then the 

j ava . awt . image . ImageObserver is notified later and -1 is returned. 

Overrides: 

getWidth in class Image 

Parameters: 

observer - the ImageObserver that receives information about the image 

Returns: 

the width of the image or -i if the width is not yet known. 

See Also: 

j ava . awt . Image . getHeight ( ImageObserver) , j ava . awt . image . ImageObserver 

setRGB(int, int, int) 

public void setRGB(int x, int y, int rgb) 

Sets a pixel in this DVBBuff eredlmage to the specified ARGB value. The pixel is assumed to be in 
the default RGB color model, TYPE_INT_ARGB, and default sRGB color space. Calls to this method 
after calls to the dispose method on the same instance shall throw an 

ArraylndexOutOf BoundsException. 

Parameters: 

X - the x-coordinate of the pixel to set 

y - the y-coordinate of the pixel to set 
rgb - the ARGB value 

Since: 

MHP 1.0 



setRGB(int, int, int, int, int[], int, int) 

public void setRGB(int startX, int startY, int w, int h, int [ ] rgbArray, int offset, 
int scansize) 

Sets an array of integer pixels in the default RGB color model (TYPE_INT_ARGB) and default sRGB 
color space, into a rectangular portion of the image data. There are only 8-bits of precision for each 
color component in the returned data when using this method. With a specified coordinate (x, y) in 
the this image, the ARGB pixel can be accessed in this way: 



pixel 



rgbArray [of f set + (y-startY) *scansize + (x-startX) ] ; 



WARNING: No dithering takes place. 

Calls to this method after calls to the dispose method on the same instance shall throw an 

ArraylndexOutOf BoundsException. 
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Parameters: 

startx - the x-coordinate of the upper-left corner of the specified rectangular region 

startY - the y-coordinate of the upper-left corner of the specified rectangular region 

w - the width of the specified rectangular region 

h - the height of the specified rectangular region 

rgbArray - the ARGB pixels 

offset - offset into the rgbArray 

scansize - SCanline stride for the rgbArray 

Since: 

MHP 1.0 

toStringO 

public j ava . lang. String toString ( ) 

Returns a string representation of this DVBBuf f eredimage object and its values. 

Overrides: 

toString in class Object 

Returns: 

a string representing this DVBBuf feredlmage. 
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org.dvb.ui 

DVBColor 



Declaration 

public class DVBColor extends j avax . tv. graphics .AlphaColor 

Java . lang .Object 

+ — j ava . awt . Color 
I 
-I javax . tv. graphics .AlphaColor 

+ — org . dvb . ui . DVBColor 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

A Color class which adds the notion of alpha. Because DVBColor extends Color the signatures in the existing 
classes do not change. Classes like Component should work with DVBColor internally. Instances of this class are a 
container for the values which are passed in to the constructor. Any approximations made by the platform are made 
when the colors are used. Note: org.dvb.ui. DVBColor adds support for alpha (compared to JDKl.1.8) and is 
intended to be compatible with the JDK1.2 java.awt.Color class - since org.dvb.ui.DVBColor extends 
javax. tv.graphics. AlphaColor which in turn extends java.awt.Color. In implementations where java.awt.Color 
supports alpha, such as JDK1.2, etc., the alpha-related methods in org.dvb.ui.DVBColor could just call super. 

Since: 

MHP 1.0 



Constructors 



DVBColor(Color) 

public DVBColor (Java . awt . Color c) 

Constructs a new DVBColor using the specified color. If c supports alpha, e.g. if it is an instance of 
javax. tv.graphics.AlphaColor or JDK 1.2's java.awt.Color, then the alpha value of c shall be used. If 
this color has no alpha value, alpha will be set to 255 (opaque). 

Parameters: 

c - the java.awt.Color used to create a new DVBColor 



DVBColor(float, float, float, float) 

public DVBColor (float r, float g, float b, float a) 

Creates an sRGB color with the specified red, green, blue, and alpha values in the range (0.0 - 1 .0). 
The actual color used in rendering will depend on finding the best match given the color space 
available for a given output device. 
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Parameters: 

r - the red component 

g - the green component 
b - the blue component 
a - the alpha component 

See Also: 

j ava . awt .Color . getRed ( ) , j ava . awt . Color . getGreen ( ) , 
j ava . awt . Color . getBlue ( ) , getAlpha ( ) , getRGB ( ) 

DVBColor(int, boolean) 

public DVBColor(int rgba, boolean hasalpha) 

Creates an sRGB color with the specified combined RGBA value consisting of the alpha component 
in bits 24-31, the red component in bits 16-23, the green component in bits 8-15, and the blue 
component in bits 0-7. If the hasalpha argument is False, alpha is defaulted to 255. 

Parameters: 

rgba - the combined RGBA components 

hasalpha - true if the alpha bits are valid, false otherwise 

See Also: 

j ava . awt . Color . getRed ( ) , j ava . awt . Color . getGreen ( ) , 
j ava . awt . Color . getBlue ( ) , getAlpha ( ) , getRGB ( ) 

DVBColor(int, int, int, int) 

public DVBColor(int r, int g, int b, int a) 

Creates an sRGB color with the specified red, green, blue, and alpha values in the range (0 - 255). 

Parameters: 

r - the red component 

g - the green component 
b - the blue component 
a - the alpha component 

See Also: 

j ava . awt .Color . getRed ( ) , j ava . awt . Color . getGreen ( ) , 
j ava . awt . Color . getBlue ( ) , getAlpha ( ) , getRGB ( ) 



Methods 



brighterO 

public Java. awt .Color brighterO 

Creates a brighter version of this color. This method applies an arbitrary scale factor to each of the 
three RGB components of the color to create a brighter version of the same color. Although brighter 
and darker are inverse operations, the results of a series of invocations of these two methods may be 
inconsistent because of rounding errors. The alpha value shall be preserved. 

Overrides: 

brighter in class AlphaColor 
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Returns: 

a new DVBColor object (cast to a java.awt.Color object) representing a brighter version of tiiis 
color. Applications can recast it to a org. dvb.ui. DVBColor object 



See Also: 

Java. awt .Color .brighter () 



darkerO 

public java.awt.Color darker ( ) 

Creates a darker version of this color. This method applies an arbitrary scale factor to each of the 
three RGB components of the color to create a darker version of the same color. Although brighter 
and darker are inverse operations, the results of a series of invocations of these two methods may be 
inconsistent because of rounding errors. The alpha value shall be preserved. 

Overrides: 

darker in class AlphaColor 

Returns: 

a new DVBColor object (cast to a java.awt.Color object), representing a darker version of this 
color. Applications can recast it to a org. dvb.ui. DVBColor object 

See Also: 

j ava . awt . Color . darker ( ) 



equals(Object) 

public boolean equals (j ava . lang. Object obj) 

Determines whether another object is equal to this color. The result is true if and only if the argument 
is not null and is a DVBColor object that has the same red, green, blue and alpha values as this 
object. 

Overrides: 

equals in class AlphaColor 

Parameters: 

obj - - the object to compare with. 

Returns: 

true if the objects are the same; false otherwise. 

Since: 

MHP 1.0 



getAlphaQ 

public int getAlpha ( ) 

Returns the alpha component. In the range 0-255. 

Overrides: 

getAlpha in class AlphaColor 

Returns: 

the alpha component 

See Also: 

getRGB () 
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getRGBO 

public int getRGBO 

Returns the RGB value representing the color in the default sRGB ColorModel. (Bits 24-31 are 
alpha, 16-23 are red, 8-15 are green, 0-7 are blue). 

Overrides: 

getRGB in class AlphaColor 

Returns: 

the RGB value representing the color in the default sRGB ColorModel. 

Since: 

MHP 1.0 

See Also: 

j ava . awt . Color . getRed ( ) , j ava . awt . Color . getGreen ( ) , 
j ava . awt . Color . getBlue ( ) , getAlpha ( ) 



toStringO 

public Java. lang. String toStringO 

Creates a string that represents this color and indicates the values of its ARGB components. 

Overrides: 

toString in class AlphaColor 

Returns: 

a representation of this color as a String object. 

Since: 

MHP 1.0 
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org.dvb.ui 

DVBGraphics 

Declaration 

public abstract class DVBGraphics extends j ava . awt . Graphics 

Java . lang .Object 

H j ava . awt . Graphics 

I 

+--org.dvb.ui .DVBGraphics 

Description 

The DVBGraphics class is a adapter class to support alpha compositing in an MHP device. Most methods 
directly delegate to java.awt.Graphics other methods could delegate to the appropriate methods in 
java.awt.Graphics2D where available or could be implemented in native code. In implementations where the class 
java.awt.Graphics2D is visible to MHP applications, org.dvb.ui. DVBGraphics inherits from java.awt.Graphics2D. 
Otherwise, org.dvb.ui. DVBGraphics inherits from java.awt.Graphics. In MHP devices all Graphics Objects are 
DVBGraphics objects. Thus one can get a DVBGraphics by casting a given Graphics object. The normal 
compositing rule used is DVBAlphaComposite.SRC_OVER. Note that the default rule of SRC_OVER may not 
give the highest performance. Under many circumstances, applications will find that the SRC rule will give higher 
performance. The intersection between setDVBCompsite in this class and the setPaintMode and 
setXORMode methods inherited from java.awt.Graphics shall be as follows. 

• Calling setPaintMode on an instance of this class shall be equivalent to calling set- 
DVBComposite (DVBAlphaComposite . SrcOver) . 

• Calling setXORMode on an instance of this class shall be equivalent to calling setDVBComposite with a 
special and implementation dependent DVBAlphaComposite object which implements the semantics specified 
for this method in the parent class. 

• Calling getDVBComposite when setXORMode is the last DVBComposite set shall return this implemen- 
tation dependent object. Conformant MHP applications shall not do anything with or to this object including 
calling any methods on it. 

• This specification does not tighten, refine or detail the definition of the setXORMode beyond what is specified 
for the parent class. 

Note: Implementations of XOR mode may change colours with alpha to without and vice versa (reversibly). 

Since: 

MHP1.0 

See Also: 

j ava . awt . Graphics 



Constructors 

DVBGraphiesO 

protected DVBGraphiesO 

Constructs a new DVBGraphics object. This constructor is tine default contructor for a grapinics 
context. 
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Since DVBGraphics is an abstract class, applications cannot call this constructor directly. 
DVBGraphics contexts are obtained from other DVBGraphics contexts or are created by casting 
java.awt.Graphics to DVBGraphics. 

Since: 

MHP 1.0 

See Also: 

j ava . awt . Graphics . create ( ) , j ava . awt . Component . getGraphics ( ) 



Methods 



getAvailableCompositeRulesO 

public abstract int[] getAvailableCompositeRulesO 

Returns all available Porter-Duff Rules for this specific Graphics context. E.g. a devices could 
support the SRC_OVER rule when using a destination which does not has Alpha or where the alpha 
is null, while this rule is not available when drawing on a graphic context where the destination has 
alpha. Which rules are supported for the different graphics objects is defined in the Minimum 
Platform Capabilities of the MHP spec. 

Returns: 

all available Porter-Duff Rules for this specific Graphics context. 

Since: 

MHP 1.0 



getBestColorMatch(Color) 

public org.dvb.ui . DVBColor getBestColorMatch (j ava . awt . Color c) 

Returns the best match for the specified Color as a DVBColor, in a device-dependent manner, as 
constrained by the MHP graphics reference model. 

Parameters: 

c - the specified Color. 

Returns: 

the best DVBColor match for the specified Color. 

Since: 

MHP 1.0 



getColorO 

public abstract Java . awt . Color getColor ( ) 

Gets this graphics context's current color. This will return a DVBColor cast to java.awt.Color. 

Overrides: 

getColor in class Graphics 

Returns: 

this graphics context's current color. 

Since: 

MHP 1.0 
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See Also: 

DVBColor, Java . awt . Color, setColor (Color) 



getDVBCompositeO 

public abstract org. dvb . ui . DVBAlphaComposite getDVBCompositeO 

Returns the current DVBAlphaComposite in the DVBGraphics context. This method could 
delegate to a java.awt.Graphics2D object where available 

Returns: 

the current DVBGraphics DVBAlphaComposite, which defines a compositing style. 

Since: 

MHP 1.0 

See Also: 

set DVBCompo site (DVBAlphaComposite) 



getTypeO 

public int getTypeO 

Returns the Sample Model (DVBBufferedlmage.TYPE_BASE, 

DVBBufferedlmage.TYPE_ADVANCED) which is used in the on/off screen buffer this graphics object 
draws into. 

Returns: 

the type of the Sample Model 

Since: 

MHP 1.0 

See Also: 

DVBBuf f eredlmage 



setColor(Color) 

public abstract void setColor (j ava . awt . Color c) 

Sets this graphics context's current color to the specified color. All subsequent graphics operations 
using this graphics context use this specified color. Note that color c can be a DVBColor 

Overrides: 

setColor in class Graphics 

Parameters: 

c - the new rendering color. 

Since: 

MHP 1.0 

See Also: 

j ava . awt . Color, DVBColor, getColor() 
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setDVBComposite(DVBAlphaComposite) 

public abstract void setDVBComposite (org . dvb . ui . DVBAlphaComposite comp) 
throws UnsupportedDrawingOperationException 

Sets the DVBAlphaComposite for the DVBGraphics context. The DVBAlphaComposite is used 
in all drawing methods such as drawimage, drawstring, draw, and fill. It specifies how new 
pixels are to be combined with the existing pixels on the graphics device during the rendering 
process. 

This method could delegate to a Graphics2D object or to an native implementation 

Parameters: 

comp - the DVBAlphaComposite object to be used for rendering 

Throws: 

UnsupportedDrawingOperationException - when the requested Porter-Duff rule is not 
supported by this graphics context 

Since: 

MHP 1.0 

See Also: 

j ava . awt . Graphics . setXORMode (Color) , j ava . awt . Graphics . setPaintMode ( ) , 
DVBAlphaComposite 



toStringO 

public Java . lang. String toStringO 

Returns a string object representing this DVBGraphics object's value. 

Overrides: 

toString in class Graphics 

Returns: 

a string representation of this graphics context. 

Since: 

MHP 1.0 
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org.dvb.ui 

DVBRasterFormatException 



Declaration 

public class DVBRasterFormatException extends j ava . lang. Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . dvb . ui . DVBRasterFormatException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

This exception is thrown for some invahd operations on instances of DVBBuf f eredlmage. The precise 
conditions are defined in the places where this exception is thrown. 

Since: 

MHP 1.0.1 

See Also: 

DVBBuf f eredlmage 



Constructors 



DVBRasterFormatException(String) 

public DVBRasterFormatException (Java . lang . String s) 

Constructs an instance of DVBRasterFormatException with tiie specified detail message. 

Parameters: 

s - tine detail message 

Since: 

MHP1.0 
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org.dvb.ui 

DVBTextLayoutManager 



Declaration 

public class DVBTextLayoutManager implements org . havi . ui . HTextLayoutManager 
Java . lang .Object 

+ — org . dvb . ui . DVBTextLayoutManager 

All Implemented Interfaces: 

org. havi . ui . HTextLayoutManager 

Description 

The DVBTextLayoutManager provides a text rendering layout mechanism for the org.havi.ui.HStaticText 
org.havi.ui.HText and org. havi. ui.HTextButton classes. 

The semantics of the rendering behaviour and the settings are specified in the "Text presentation" annex of this 
specification. The DVBTextLayoutManager renders the text according to the semantics described in that annex. 



Fields 

HORIZONTAL_CENTER 

public static final int HORIZONTAL_CENTER 

The text should be centered horizontally. 
HORIZONTAL_END_ALIGN 

public static final int HORIZONTAL_END_ALIGN 

The text should be horizontally to the horizontal end side (e.g. when start corner is upper left and line 
orientation horizontal, meaning text that is read left to right from top to bottom, this implies alignment 
to right). 

HORIZONTAL_START_ALIGN 

public static final int HORIZONTAL_START_ALIG!N 

The text should be aligned horizontally to the horizontal start side (e.g. when start corner is upper left 
and line orientation horizontal, meaning text that is read left to right from top to bottom, this implies 
alignment to left). 

LINE_ORIENTATION_HORIZONTAL 

public static final int LINE_ORIENTATION_HORIZONTAL 

Horizontal line orientation. 
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LINE_ORIENTATION_VERTICAL 

public static final int LINE_ORIENTATION_VERTICAL 

Vertical line orientation. 



START_CORNER_LOWER_LEFT 

public static final int START_CORNER_LOWER_LEFT 

Lower left text start corner. 



START_CORNER_LOWER_RIGHT 

public static final int START_CORNER_LOWER_RIGHT 

Lower right text start corner. 



START_CORNER_UPPER_LEFT 

public static final int START_CORNER_UPPER_LEFT 

Upper left text start corner. 



START_CORNER_UPPER_RIGHT 

public static final int START_CORNER_UPPER_RIGHT 

Upper right text start corner. 



VERTICAL_CENTER 

public static final int VERTICAL_CENTER 

The text should be centered vertically. 



VERTICAL_END_ALIGN 

public static final int VERTICAL_END_ALIG!N 

The text should be aligned vertically to the vertical end side (e.g. when start corner is upper left and 
line orientation horizontal, meaning text that is read left to right from top to bottom, this implies 
alignment to bottom). 

This is defined by the section "Vertical limits" in the "Text presentation" annex of this specification. 
VERTICAL_START_ALIGN 

public static final int VERTICAL_START_ALIGN 

The text should be aligned vertically to the vertical start side (e.g. when start corner is upper left and 
line orientation horizontal, meaning text that is read left to right from top to bottom, this implies 
alignment to top). 

This is defined by the section "Vertical limits" in the "Text presentation" annex of this specification. 
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Constructors 



DVBTextLayoutManagerO 

pub 1 i c DVBTextLayoutManager ( ) 

Constructs a DVBTextLayoutManager object with default parameters 

(HORIZONTAL_START_ALIGN, VERTICAL_START_ALIGN, LINE_ORIENTATION_HORIZONTAL, 
START_CORNER_UPPER_LEFT, wrap = true, linespace = (point size of tine default font for 
HVisible) + 7, letterspace = 0, horizontalTabSpace = 56) 

DVBTextLayoutManager(int, int, int, int, boolean, int, int, int) 

public DVBTextLayoutManager (int horizontalAlign, int verticalAlign, int lineOrientation, 
int startCorner, boolean wrap, int linespace, int letterspace, 
int horizontalTabSpace) 

Constructs a DVBTextLayoutManager object. 

Parameters: 

horizontalAlign - Horizontal alignment setting 

verticalAlign -Vertical alignment setting 

lineOrientation - Line orientation setting 

StartCorner - Starting corner setting 

wrap - Text wrapping setting 

linespace - Line spacing setting expressed in points 

letterspace - Letterspacing adjustment relative to the default letterspacing. Expressed in 
units of 1 /256th point as the required increase in the spacing between consecutive characters. 
May be either positive or negative. 

horizontalTabSpace - Horizontal tabulation setting in points 



Methods 



addTextOverflowListener(TextOverflowListener) 

public void addTextOverf lowListener (org. dvb . ui . TextOverf lowListener 1) 

Register a TextOverflowListener that will be notified if the text string does not fit in the component 



when rendering. 

Parameters: 

1 - a listener object 



getHorizontalAlignO 

public int getHorizontalAlignO 

Get the horizontal alignment. 

Returns: 

Horizontal alignment setting 
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getHorizontalTabSpacingO 

public int getHorizontalTabSpacingO 

Get the horizontal tabulation spacing. 

Returns: 

the horizontal tabulation spacing 



getlnsetsO 

public Java. awt . Insets getlnsetsO 

Returns the insets set by the setlnsets method. These Insets are added to the ones passed to the 
render method for rendering the text. When not previously set, zero Insets are returned. 



Returns: 

Insets set by the setlnsets method 



getLetterSpaceO 

public int getLetterSpaceO 

Get the letter space setting. This is a 16 bit signed integer specifying in units of 1 /256th point the 
required increase in the spacing between consecutive characters. It corresponds to the "track" 
parameter in the MHP text rendering rules. 



Returns: 

letter space setting 



getLineOrientationO 

public int getLineOrientationO 

Get the line orientation. 

Returns: 

Line orientation setting 



getLineSpaceO 

public int getLineSpaceO 

Get the line space setting. 

Returns: 

line space setting or -1 , if the default line spacing is determined from the size of the default font 



used. 



getStartCornerO 

public int getStartCorner () 

Get the starting corner. 

Returns: 

Starting corner setting 
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getTextWrappingO 

public boolean getTextWrappingO 

Get the text wrapping setting. 

Returns: 

text wrapping setting 



getVerticalAlignO 

public int getVerticalAlignO 

Get tine vertical alignment. 

Returns: 

Vertical alignment setting 



removeTextOverflowListener(TextOverflowListener) 

public void removeTextOverf lowListener (org . dvb . ui . TextOverf lowListener 1) 

Removes a TextOverflowListener that has been registered previously. 

Parameters: 

1 - a listener object 



render(String, Graphics, HVisible, Insets) 

public void render (Java . lang . String markedUpString, Java . awt . Graphics g, 
org . havi . ui . HVisible v, j ava . awt . Insets insets) 

Render the string. The HTextLayoutManager should use the passed HVisible object to 
determine any additional information required to render the string, e.g. Font, Color etc. 

The text should be laid out in the layout area, which is defined by the bounds of the specified 
HVisible , after subtracting the insets. If the insets are null the full bounding rectangle is used as 
the area to render text into. 

The HTextLayoutManager should not modify the clipping rectangle of the Graphics object. 

Specified By: 

render in interface HTextLayoutManager 

Parameters: 

markedUpString - the string to render. 

g - the graphics context, including a clipping rectangle which encapsulates the area within which 
rendering is permitted. If a valid insets value is passed to this method then text must only be 
rendered into the bounds of the widget after the insets are subtracted. If the insets value is null 
then text is rendered into the entire bounding area of the HVisible . It is implementation 
specific whether or not the renderer takes into account the intersection of the clipping rectangle 
in each case for optimization purposes. 

V - the HVisible into which to render. 

insets - the insets to determine the area in which to layout the text, or null. 
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setHorizontalAlign(int) 

public void setHorizontalAlign (int horizontalAlign) 

Set the horizontal alignment. The setting shall be one of horizontal_center, 
HORizoNTAL_END_ALiGN or HORizoNTAL_START_ALiGN. The failure mode If Other values are 
used is implementation dependent. 

Parameters: 

horizontalAlign - Horizontal alignment setting 

setHorizontalTabSpacing(int) 

public void setHorizontalTabSpacing (int horizontalTabSpace) 

Set the horizontal tabulation spacing. 

Parameters: 

horizontalTabSpace - tab spacing in points 

setlnsets(Insets) 

public void setlnsets (j ava . awt . Insets insets) 

Sets the insets which shall be used by this DVBTextLayoutManager to provide a "virtual margin". 
These shall be added to the insets passed to the Render method (which are to be considered as 
"bounds"). If this method is not called, the default insets are at each edge. 

Parameters: 

insets - Insets that should be used 



setLetterSpace(int) 

public void setLetterSpace (int letterSpace) 

Set the letter space setting. This is a 16 bit signed integer specifying in units of 1 /256th point the 
required increase in the spacing between consecutive characters. It corresponds to the "track" 
parameter in the MHP text rendering rules. 

Parameters: 

letterSpace - letter space setting 

setLineOrientation(int) 

public void setLineOrientation (int lineOrientation) 

Set the line orientation. The setting shall be one of line_orientation_vertical, 
LiNE_ORiENTATiON_HORizoNTAL. The failure mode if other values are used is implementation 
dependent. 

Parameters: 

lineOrientation - Line orientation setting 

setLineSpace(int) 

public void setLineSpace (int lineSpace) 

Set the line space setting. Using -1 as the line space setting shall cause the line spacing to be 
determined from the size of the default font. 
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Parameters: 

lineSpace - line space setting 



setStartComer(int) 

public void setStartCorner (int startCorner) 

Set tine starting corner. Tine setting sinall be one of start_corner_upper_left, 

START_CORNER_UPPER_RIGHT, START_CORNER_LOWER_LEFT or 

START_CORNER_LOWER_RIGHT. The failure mode if other values are used is 
implementation dependent. 

Parameters: 

StartCorner - Starting corner setting 

setTextWrapping(boolean) 

public void setTextWrapping (boolean wrap) 

Set the text wrapping setting. 

Parameters: 

wrap - Text wrapping setting 

setVerticalAlign(int) 

public void setVerticalAlign (int verticalAlign) 

Set tine vertical alignment. The setting shall be one of vertical_center, vertical_end_align 
or vertical_start_align. The failure mode if other values are used is implementation 
dependent. 

Parameters: 

verticalAlign - Vertical alignment setting 
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org.dvb.ui 

FontFactory 

Declaration 

public class FontFactory 
Java . lang .Object 

+ — org . dvb . ui . FontFactory 

Description 

Provides a mechanism for applications to instantiate fonts that are not built into the system. The two constructors of 
this class allow fonts to be downloaded either through the font index file of the application or directly from a font 
file in the format(s) specified in the main body of the specification. 



Constructors 



FontFactoryO 

pub 1 i c FontFactory ( ) 

throws FontFormatException, lOException 

Constructs a FontFactory for the font index file bound to \h\s application in the application signalling. 
The call to the constructor is synchronous and shall block until the font index file has been retrieved 
or an an exception is thrown. 

Throws: 

FontFormatException - if there is an error in the font index file bound with the application. 

Java. io. lOException - if there is no font index file bound with the application, or if there is an 
error attempting to access the data in that file. 



FontFactory(URL) 

public FontFactory (Java. net .URL u) 

throws lOException, FontFormatException 

Constructs a FontFactory for the font file found at the given location. The call to the constructor is 
synchronous and shall block until the font file has been retrieved or an exception is thrown. 

Parameters: 

u - The location of the font file 

Throws: 

j ava . io . lOException - if there is an error attempting to access the data referenced by the 
URL 

Java. lang. IllegalArgumentException - if the URL is not both valid and supported 

j ava . lang . SecurityException - if access to the specified URL is denied by security policy 

FontFormatException - if the file at that URL is not a valid font file as specified in the main 
body of this specification 
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Methods 



createFont(String, int, int) 

public Java . awt . Font createFont (Java . lang . String name, int style, int size) 

throws FontNotAvailableException, FontFormatException, lOException 

Creates a font object from the font source associated with this FontFactory. This font will remain valid 
even if the FontFactory is no longer reachable from application code. The name returned by 
Font.getNameO might not be the same as the name supplied, for example, it might have a string 
prepended to it that identifies the source FontFactory in a platform-dependant manner. For 
FontFactory instances bound to the font index file of an application, the call to the method is 
synchronous and shall block until either an exception is thrown or any required network access has 
completed. 

The value of the style argument must be as defined in java.awt.Font. Valid values are the following: 

• java.awt.Font . PLAIN 

• Java. awt . Font .BOLD 

• java.awt.Font . ITALIC 

• java.awt.Font .BOLD + Java . awt . Font . ITALIC 

Parameters: 

name - the font name 

style - the constant style used, such as java.awt.Font. PLAIN. 
size - the point size of the font 

Throws: 

FontNotAvailableException - if a font with given parameters cannot be located or created. 

j ava . io . lOException - if there is an error retrieving a font from the network. Thrown only for 
font factory instances bound to the font index file of an application. 

Java. lang. IllegalArgumentException - if the style parameter is not in the set of valid 
values, or if the size parameter is zero or negative. 

FontFormatException - if the font file is not a valid font file as specified in the main body of 
this specification. Thrown only for font factory instances bound to the font index file of an 
application. 
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org.dvb.ui 

FontFormatException 



Declaration 

public class FontFormatException extends j ava . lang . Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org.dvb .ui .FontFormatException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Thrown when attempt is made to read a file describing a font when the contents of that file are not valid. 



Constructors 

FontFormatExceptionQ 

public FontFormatException ( ) 

Constructs a FontFormatException with null as its error detail message. 
FontFormatException(String) 

public FontFormatException (Java . lang . String s) 

Constructs a FontFormatException witin tine specified detail message. The error message string 
s can later be retrieved by the j ava. lang. Throwable. getWessage () method of class 

j ava . lang . Throwable. 

Parameters: 

s - the detail message. 
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org.dvb.ui 

FontNotAvailableException 



Declaration 

public class FontNotAvailableException extends j ava . lang .Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . dvb . ui . FontNotAvailableException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

Thrown when attempt is made to instantiate a font that cannot be located. 



Constructors 

FontNotAvailableExceptionO 

public FontNotAvailableException () 

Constructs a FontNotAvailableException with null as its error detail message. 
FontNotAvailableException(String) 

public FontNotAvailableException (j ava . lang . String s) 

Constructs a FontNotAvailableException witin the specified detail message. The error 
message string s can later be retrieved by the j ava . lang . Throwable . getMessage ( ) method 

of class j ava . lang . Throwable. 

Parameters: 

s - the detail message. 
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org.dvb.ui 

TestOpacity 



Declaration 

public interface TestOpacity 

Description 

Interface implemented by Components or Containers in order to allow the platform to query whether their paint 
method is fully opaque. 



Methods 



isOpaqueO 

public boolean isOpaque ( ) 

Returns true if the entire area of tine component as given by the getBounds method, is fully opaque. 
Hence its paint method (or surrogate methods) guarantees that all pixels are painted in an opaque 
Color. 

Classes implementing this interface shall return true from their implementation of this method if and 
only if their implementation can guarantee full opacity. The consequences of an invalid overridden 
value are implementation specific. 

Returns: 

true if all the pixels with the java.awt.Component#getBounds method are fully opaque, otherwise 
false. 
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org.dvb.ui 

TextOverflowListener 



Declaration 

public interface TextOverflowListener extends java.util .EventListener 

All Superinterfaces: 

j ava . util . EventListener 

Description 

The TextOverflowListener is an interface that an apphcation may implement and register in the 
DVBTextLayoutManager. This hstener wifl be notified if the text string does not fit within the component as a 
result of a call to the render method. It is the rendering process which triggers this event to be dispatched. The 
timing of this is implementation dependent. 



Methods 



notify TextOverflow(String, HVisible, boolean, boolean) 

public void notifyTextOverf low (Java . lang . String markedUpString, org .havi .ui . HVisible v, 
boolean overt lowedHorizontally, boolean overt lowedVertically) 

This method is called by the DVBTextLayoutManager if the text does not fit within the component 

Parameters: 

markedUpString - the string that was successfully rendered within the component 

V - the HVisible object that was being rendered 

overf lowedHorizontally - true if the text overflew the bounds of the component in the 
horizontal direction; otherwise false 

overf lowedVertically - true if the text overflew the bounds of the component in the vertical 
direction; otherwise false 
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org.dvb.ui 

UnsupportedDrawingOperationExce 
ption 

Declaration 

public class UnsupportedDrawingOperationException extends Java . lang. Exception 

Java . lang .Object 

H j ava . lang . Throwable 

I 

-I Java . lang .Exception 

+ — org . dvb . ui . UnsupportedDrawingOperationException 

All Implemented Interfaces: 

Java .io.Serializable 

Description 

The UnsupportedDrawingOperationException class represents an exception that is thrown if an 
drawing operation is not supported on this platform. E.g. DVBGraphics.setComposite could throw an Exception 
when setting the DST_IN rule on some devices while the SRC_OVER rule will always work. 

Since: 

MHP 1.0 



Constructors 

UnsupportedDrawingOperationException(String) 

public UnsupportedDrawingOperationException (Java . lang . String s) 

Constructs an instance of UnsupportedDrawingOperationException with tine specified detail 
message. 

Parameters: 

s - the detail message 

Since: 

MHP1.0 
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Annex V: Void 
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Annex W (informative): DVB-J examples 

W.1 DVB-J Application lifecycle implementation example 

import org . havi . ui . HScene; 

import org. havi .ui .HSceneFactory; 

import Java . awt . Component ; 

import Java . awt . BorderLayout; 

import org . dvb . ui . DVBColor ; 

import javax . tv . xlet . Xlet ; 

import javax .tv.xlet .XletContext; 

import javax . tv . xlet . XletStateChangeException; 

public class HelloDVB extends Component implements Xlet { 

private XletContext context; 
private HScene scene; 

public void initXlet (XletContext context) throws XletStateChangeException { 

this. context = context; 

scene = HSceneFactory . getlnstance (). getDef aultHScene () ; 

scene. setBounds ( 90,72,540,432 ); 

scene . setLayout (new BorderLayout (0, 0)); 

scene . add (this, "Center"); 
} 

public void startXlet() throws XletStateChangeException { 

scene . set Visible (true) ; 

requestFocus () ; 
} 

public void pauseXletO { 

scene . set Visible (false) ; 
} 

public void destroyXlet (boolean unconditional) throws XletStateChangeException ( 
scene . dispose () ; 

} 

public void paint (Java . awt . Graphics g) { 

g.setColor (new DVBColor (0, 0, 70, 180)); 

g. f illRect (0, 0, getSize (). width, getSize () .height ) ; 

g. set Color (DVBColor .yellow) ; 

g.drawString("Hello DVB", (getSize (). width-110 ) / 2, getSize (). height / 2); 



A simple example of Xlet lifecycle is a stock ticker application that uses a back chamiel to retrieve stock quotes, which it 
displays on the viewer's television. 

a) The application manager retrieves the Xlet's code. 

b) The application manager creates an instance of the XletContext Object and initializes it for the new Xlet. 

c) The application manager initializes the Xlet by calling its initXlet () method and passing it the context 
object. 

d) The Xlet uses the context object to initialize itself and enters the Paused state. 

e) The application manager calls the Xlet's startxlet ( ) method. The application manager assumes that the Xlet 
is performing its service. 

f) Upon receiving this signal, the Xlet creates a new thread that opens the back channel to retrieve the stock quotes. 
The Xlet is now in the Active state. 

g) The Xlet begins to show the stock quotes. 

h) Due to circumstances beyond the control of the Xlet, it is no longer able to retrieve updated stock quotes. 
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i) The Xlet decides to continue displaying the most recent quotes it has. Note that the Xlet is still in the Active 

state. 

j) After a time, the Xlet is still unable to open the back channel. It decides that the quotes it is displaying are too old 
to present and that it can no longer perform its service. It chooses to take itself out of the Act ive state. It calls 
the paused ( ) method on XletContext to signal this change to the application manager 

k) Finally, the Xlet decides it no longer has any chance of performing its service, so it decides it should be 
terminated. It calls the destroyed ( ) method on the XletContext to signal application manager that it has 
entered the Destroyed state. The Xlet does some final clean up. 

1) The application manager prepares the Xlet for garbage collection. 

W.2 Example of exporting an object for inter-application 
communication 

public interface MyService extends Java . rmi . Remote { 

public String getDataO throws Java . rmi . RemoteException; 
} 

public class MyServer implements MyService ( 

private static javax. tv. xlet .XletContext ctx; 

public String getDataO throws Java . rmi . RemoteException ( 

return "Hello from " + ctx . getXletProperty ( "dvb . app . id" ) ; 

} 

// 

// Called upon Xlet initialization 

// 

public static void export (XletContext ctx) { 

this. ctx = ctx; 

Remote server = new MyServer (); 

org . dvb . io . ixc . IxcRegistry . bind (ctx, "myserver", server); 
} 

// 

// Try to import the object that we previously exported. 

// Note that this would typically be done from a different 

// Xlet, but importing from yourself works, too. 

// Called when the Xlet is run. 

// 

public static void import (XletContext ctx) { 

String appid = (String) ctx . getXletProperty ( "dvb . app . id" ) ; 

String orgid = (String) ctx . getXletProperty ( "dvb . org . id" ) ; 

Remote obj; 
try { 

org . dvb . io . ixc . IxcRegistry . lookup (ctx, "/" + orgId + "/" + appId + "/myserver"); 

MyService r = (MyService) obj; 

System. out .println ( "Success " + r 

+ ", " + r .getData () ) ; 
} catch (Exception ex) ( 



W.3 Example of use of video drip feed 

import Java . lang . *; 

import java.io.*; 

import javax . tv . xlet . *; 

import javax .media . *; 

import Java . net . URL; 

import org . dvb .media . DripFeedPermission; 

import org . dvb .media . DripFeedDataSource; 
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/** 

* VideoDripTest creates an instance of DripFeedDataSource and creates a player 

* using this source. 
*/ 

public class SingleVideoDripTest implements javax . tv . xlet . Xlet 
{ 

static final int MAX_DRIP_DATA_SIZE = 32000; 

private DripFeedDataSourcedripDataSource = null; 

private Player dripPlayer = null, oldPlayer = null; 

public void initXlet (XletContext ctx) throws XletStateChangeException 
{ 

/* Check if this application has permission to play video drip 

* feed or not . 

*/ 
System. err. println ("initXlet called") ; 

SecurityManager sm = System. getSecurityManager () ; 

System. err .println ( "Checking the permission"); 

if (sm != null) { 
try { 

sm. checkPermission (new DripFeedPermission ("")); 
} 
catch ( Java . lang . SecurityException ex) { 

throw new XletStateChangeException (ex . getMessage ()) ; 



System. err .println ( "Exiting initXlet method"); 



public void startXletO throws XletStateChangeException 

{ 

byte[] dripData = new byte [MAX_DRIP_DATA_SIZE] ; 

/* Assumption: No media player is active. If this is not true, we 
* need to get the current player and stop/close it. 
*/ 

System. err. print In ("startXlet called" ) ; 

try { 

/* Create a data source for video drip */ 
dripDataSource = new DripFeedDataSource () ; 

System. err . println ( "Got the DataSource" ) ; 

/* Create a player and start it */ 

dripPlayer = Manager . createPlayer (dripDataSource) ; 
} 

catch (lOException ioel) 
{ 

System. err. print In (ioel . getMessage ( ) ) ; 

throw new XletStateChangeException (ioel . getMessage ()) ; 
} 

catch (NoPlayerException pse) 
{ 

System. err. print In (pse. getMessage ( ) ) ; 

throw new XletStateChangeException (pse . getMessage ()) ; 



System. err .println ( "Starting Drip Player"), 

dripPlayer .start () ; 

System. err .println ( "Started the player"); 

/* Read drip data from a file */ 
try 
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{ 

FilelnputStream fin = new FilelnputStrearn ( "images .mpg" ) ; 

f in . read (dripData) ; 

fin . close ( ) ; 
} 

catch (lOException ioe2) 
{ 

System. err . println (" lOException : " + ioe2 . getMessage ( ) ) ; 

throw new XletStateChangeException (ioe2 . getMessage ()) ; 
} 

catch (SecurityException se) 
{ 

System. err. print In (se. getMessage ( ) ) ; 

throw new XletStateChangeException ( "Security Exception" + se . getMessage ()) , 



System. err .println ( "Feeding data to the datasource" ) , 

/* Feed the data to the data source */ 
dripDataSource . feed (dripData) ; 

System. err .println ("Fed data to the datasource"); 



public void pauseXletO 
{ 



public void destroyXlet (boolean unconditional) 
{ 

dripP layer . close () ; 



W.4 Example of CPU bound animation 

/** 

* This is an example of doing CPU-bound animation. This 

* code attempts to do animation as fast as possible, using 

* a low-priority thread so that the animation doesn't interfere 

* with more important tasks, like responding to user input. Animation 

* is limited to 25 frames per second, just in case we're running on 

* a really fast box. 
** / 

import Java . awt . Graphics; 

import Java . awt . Component; 

import Java . awt . Dimension; 

import Java . awt .Toolkit; 

import org . dvb . ui . DVBBuf f eredlmage; 

public abstract class AnimatedView extends Component implements Runnable { 

private Thread worker = null; 
private Graphics theScreen = null; 
private DVBBuf f eredlmage buffer = null; 
private boolean stopping = false; 

/** 

* Called by the Xlet to start animation. Must never be called 

* when animation is in progress! 

public synchronized void startAnimation ( ) { 
if (worker != null) { 

throw new IllegalStateException ( ) ; // It's a bug 
} 

worker = new Thread (this) ; 

worker . setPriority (2 ); // Animation is CPU-bound 
theScreen = get Graphics ; // Component . get Graphics ( ) 
Dimension d = getSizeO; 
buffer = new DVBBuf f eredlmage (d. width, d. height); 
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stopping = false; 
worker . start { ) ; 



/** 
* Stop animation, and don't return until it has stopped. 

public synchronized void stopAnimation ( ) { 
if (worker == null) { 

throw new IllegalStateException ( ) ; // it's a bug 
} 

stopping = true; 
for (;;) {// Wait until stopped 

if (Thread. interrupted ) { // Xlet being terminated 
return; 
} 

notifyAll () ; 
try { 
wait ; 

} catch (InterruptedException ex) { 
Thread. current Thread ( ) . interrupt ( ) ; 
} 

if ( ! stopping) { 
theScreen . dispose () ; 
theScreen = null; 
buffer . flush ( ) ; 
buffer = null; 
worker = null; 
return; 



/** 

* Run the animation until stopped. Called from the worker thread 

* only. This will probably be CPU-bound, as it sets an ambitious 

* target of 25fps animation. 

public void run ( ) { 

long start = System. currentTimeMillis () ; 
long lastFrameTime = start - 40; 
long now = 0; 

animation : 
for (;;) { 

// Wait until at least 1/25 of a second after last frame, and 
// bail out of thread if we're stopping 
synchronized (this) { 
for (;;) { 

if (stopping) { 
stopping = false; 
notifyAll () ; 
return; 
} 

if (Thread. interrupted () ) { // Xlet being terminated 
return; 
} 

now = System. currentTimeMillis () ; 
long delta = now - lastFrameTime; 
if (delta >= 40) { 
break; 

} else { 
try { 

wait (40 - delta) ; 
} catch (InterruptedException ex) ( 

Thread. current Thread ( ) . interrupt ( ) ; 
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lastFrameTime = now; 

long timeSinceStart = now - start; 

Graphics g = but f er . getGraphics ( ) ; 

for (int part = 0; part < getNumParts ( ) ; part++) ( 
drawPart (part , g, timeSinceStart); 

if (shouldStopO ) { 

continue animation;// Bail out if animation should stop 



g. dispose () ; 

theScreen . drawlmage (buf f er , 0, 0, null), 

Toolkit .getDefault Toolkit () . sync () ; 



private synchronized boolean shouldStopO { 
return Thread. interrupted () | | stopping; 



public synchronized void paint (Graphics g) { 

if (worker == null | | stopping) { 

// Paint whatever we paint when we're not animating 

} else { 

// Probably do nothing. If our animation target were 
// significantly less than 25 fps, we'd want to set a variable 
// to cause a repaint ASAP, then call notifyAll() to break 
// the animation loop out of any wait() it might be in. 



* Draw a part of the animation. For each frame, AnimatedView will call 

* this method first for part 0, then part 1, up to getNumParts () -1 . 

* Between each part, AnimatedView will check if animation needs to 

* stop for some reason . 

* <p> 

* Subclasses should ensure that drawing the entire scene is divided 

* into enough parts to ensure that animation can be stopped quickly. 

* @see # getNumParts 
*/ 

protected abstract void drawPart (int num, Graphics g, long timeSinceStart), 

/** 

* @return the number of parts in this animation. This determines how 

* many times drawPart will be called. 

* @see # drawPart 
*/ 

protected abstract int getNumParts () ; 
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Annex X (normative): Test support 
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Package 

org.dvb.test 



Description 

In a broadcast-based conformance system, there are effectively three main entities involved in an automated test 
process: 

1. The test server that is used to hold and initiate all of the tests. 

2. The test client which runs the tests and logs the results. 

3. The broadcast chain that is used to transfer applications and application data from the server to the client. 
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The communication order is as follows: 

1. The test-server uses the "reset for next test" mechanism to set the test client into a known default state, ready to 
receive the test-application. 

2. The test-server uses the "broadcast chain" mechanism to supply the test-application to the test client and to sig- 
nal that the test-application should be executed. 

3. The test-client runs the test-application. 

4. The test-application either: 

• finishes within a given timelimit, the result of the test is known and shall be considered to be the value reported 
by the test application for the purposes of compliance. 

• Optionally, the test-client may signal to the test-server that the test-application has finished executing and that 
the test-client is ready to be reset in order to receive the next test-application. 

• fails to finish the test-application within a given timeout, the result of the test is unknown and shall be treated 
as a failure for the purposes of compliance. The test-server may treat the test-client as ready to be reset in order 
to receive the next application. 

[Successive tests are then repeated from stage 1 .] 

"Reset for next test" 

The "reset for next test" path is used by the test server to reset the test client to receive the next test. The reset for 
next test API is considered to be a private implementation issue between the test-server and test-client and therefore 
has no public Java API implications. Note that this "communication" needs to take place prior to any application 
being executed. Note that the precise manner of the reset mechanism is intentionally not specified — in the worst 
case, this may involve "power cycling" the test client. 
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Test log 

Communication from the test client to the test log is considered as write-only access. Hence, results from 
successive tests cannot overwrite results from previous ones. Multiple (intermediate) results may be sent to the test 
log for any given test. It is recommended that all communication to the test log is synchronous. 

See the DVBTest.log method for details of the proposed API and implementation issues. 

"Test completed" 

The "test completed" path is used by the test client to indicate to the test server that it has completed the previous 
test and is now able to accept a subsequent one. Note that this communication path is an optimisation, since direct 
communication from the client to the server is not actually required, e.g. the server might simply "time-out" the 
client, and then perform a "reset for next test" action. However, this optimisation may be important when large 
numbers of tests are being performed on a "capable" platform, since e.g. if a 30 second timeout is applied for 1000 
test cases which typically run within say 6 seconds, then the timeout implies a typical running time of 500 minutes, 
i.e. -4.5 hours rather than 100 minutes, i.e. -1.5 hours. 

See the DVBTest. terminate method for details of the proposed API and implementation issues. 

Access test log 

The mechanism by which the test-log is accessed is not considered in this document, this is a private mechanism, 
which might include reading a file from flash / RAM. Similarly, the mechanism by which results are recovered 
from the test log is not considered in this document, e.g. the test-log may actually reside on the test server, e.g. as in 
the case that results are transmitted over an IP connection. 



Class Summary 



Classes 

DVBTest jhe DVBTest class allows test applications to log messages during their exe- 

cution and to indicate their termination condition in a platform independent 
manner. 



ETSI 



736 ETSITS 101 812V1.3.1 (2003-06) 



org.dvb.test 

DVBTest 



Declaration 

public class DVBTest 
Java . lang .Object 

+ — org.dvb.test .DVBTest 

Description 

The DVBTest class allows test applications to log messages during their execution and to indicate their termination 
condition in a platform independent manner. 

A number of constants are defined in the DVBTest class and are reserved as follows 

• Zero and negative values defined within the class are reserved by DVB. 

• Positive return values are available for test application specific return values, which must be defined within the 
procedure for executing the test application as to their precise meaning as regards conformance. 



Fields 

FAIL 

public static final int FAIL 

The application executed and terminated unsuccessfully and has therefore operated in a non- 
conformant manner. 

HUMANJNTERVENTION 

public static final int HUMAN_INTERVENTION 

The application is unable to determine whether it has operated conformantly and therefore requires 
some human intervention to determine whether conformance has been achieved. Until the 
application has been checked the result of the application should be considered as non-conformant. 

It is envisaged that tests returning this value may be those requiring evaluation of presented content, 
such as graphics, etc. Such presentation may require (subjective) human evaluation. 

OPTION_UNSUPPORTED 

public static final int OPTION_UNSUPPORTED 

The platform does not contain the option under test and therefore the test is inapplicable, the test 
result should not be considered when determining the status of the platform's conformance. 

PASS 

public static final int PASS 

The application executed and terminated successfully and has therefore operated in a conformant 
manner. 
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UNRESOLVED 

public static final int UNRESOLVED 

A setup stage necessary to execute the application failed, and hence the result of the application is 
unknown and therefore should be considered to have operated in a non-conformant manner. 

UNTESTED 

public static final int UNTESTED 

The application ran successfully, but the particular test was unable to execute. Hence the result of is 
unknown, and may require human evaluation to determine conformance. 

For example, an out of disk space test may not execute within a fixed number of iterations (within a 
practical amount of time) for devices with large capacity storage, etc. 



Methods 



log(String, int) 

public static void log (Java . lang . String id, int no) 
throws lOException 

This method has the same behaviour, implementation options and restrictions as log(String, String) - 
except that, it allows an integer value to be logged, rather than a String, which may prove a useful 
option for automating tests. 

Parameters: 

id - a string identifying the application (thread) that is logging the test result. 

no - the integer value that the application wishes to be logged. 

Throws: 

j ava . io . lOException - under the same conditions as log(String, String). 



log(String, String) 

public static void log (Java . lang. String id, Java . lang . String message) 
throws lOException 

This synchronous, blocking, method logs a result (intermediate result) of a test application using 
write-only access. The method takes both an identifier string, e.g. "Test number 1" and a message to 
output, e.g. "Now invoking the xletPause method...". The application is not required to open a file or 
network connection, per se, and the logQ method is always available for writing (in principle). 

The precise format of the logged message is left deliberately unspecified, implementers may choose 
to output compressed messages, XML documents, or other formats of their choice (obviously 
provided that the original information can be recovered). It is an implementation option to include 
additional information with each logging message, e.g. including: 

• version of the specification being implemented 

• compiler version and options. 

• build-version 

• timestamp 

• date 

• debug info 
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Messages sent using this metlnod sinould "atomic", i.e. tinat tiney are not interleaved witin otiner 
messages sent using tine metinods defined in tine DVBTest class. 

Implementation 

The precise mechanism(s) by which the this method may be implemented are intentionally 
unspecified, implementation options might include: 

• logging the message to a local file system. 

• logging the message to a mounted remote file system. 

• logging the message to a RAM disk, etc. 

• logging the message via an RS-232 (or other serial) connection. 

• logging the message to a remote host via some IP / UDP based mechanism, e.g. using a socket-based con- 
nection. 

Note that the implementation of the log method may use the same or a different mechanism to that 
used by the terminate method. 

The log method does not require any explicit initialisation on the part of the application under test. 
For example if messages are being stored to a file system, then the application is not required to 
mount / open any storage file. Similarly, if the messages are being logged via a network connection, 
then the application is not required to open a connection to the storage host, etc. In principle, the 
mechanism should always be available to accept messages. 

If this method is implemented on top of some buffering mechanism, it is strongly recommended that 
the buffer be flushed for each occurrence of a message being logged. 

Security and implementation options 

There is no Java security mechanism that is used to secure the log method. 

Note that even if the log method is based on a particular implementation option, it shall be able to 
operate in spite of that particular implementation option itself being subject to security checks. For 
example, a log method implemented using the java.net.Socket class shall always be able to log a 
message from a test-application, even if the test-application is unable to directly access the 
java.net.Socket class due to security restrictions, etc. 

It is an allowed implementation option to require that the test-client be put into some particular "test- 
mode" before any test-results are logged. This mechanism is required to reduce any inadvertent 
interaction due to downloaded applications accessing the test methods. 

Authoring guidelines 

The log method is not intended to be accessed by downloaded applications directly, it is purely 
intended for the use of conformance test applications. Authors of downloaded applications should 
not call this method, since there may be interactions between this method and normal in-field 
operation of the test-client (MHP platform). 

It is an allowed implementation option to require that the test-client be put into some particular "test- 
mode" before any test-results are logged. This mechanism is required to reduce any inadvertent 
interaction due to downloaded applications accessing the test methods. 

It is an allowed implementation option to have a number of "test-modes" that are appropriate to 
different elements being conformance tested, for example, it is a valid implementation for a test-client 
to have a test-mode where results are stored via a serial port, and a separate test-mode where 
results are stored via a RAM disk. It is allowable for a conformance test to be performed with the test- 
client in some specific test- mode, e.g. a java.net test (using a serial modem) might have its test 
results logged to a RAM disk, to avoid interaction between test-log messages and the serial protocol. 

The mechanism by which a test-client is put into a given test mode is intentionally left unspecified. 

Relationship to java.io 
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It is an implementation option to map the implementation of this method onto corresponding write 
method(s) of appropriate java.io classes. These classes may in turn be obtained, e.g. from java.net 
Socket classes, etc. 

Parameters: 

id - a string identifying the application (thread) that is logging the test result. 

message - the message that the application wishes to be logged. 

Throws: 

j ava . io . lOException - if there is any problem in providing synchronous logging to an 
application. This lOException may be due to failure to write to a file system, inability to access a 
remote socket, etc. the precise causes are deliberately unspecified and are implementation 
dependent. 



prompt(String, int, String) 

public static void prompt (j ava . lang. String id, int controlCode, j ava . lang . String message) 
throws lOException 

This is a method is used to "approximately" synchronise a test-client and test-server, the method 
blocks until the test-server positively or negatively acknowledges the particular message. The 
intended use of this method is to remove critical timing issues from conformance tests, e.g. a 
conformance test to ensure that an Xlet responds to a change in broadcast signalling must first 
ensure that the Xlet is in a state where it is able to respond to such signalling — since the time taken 
for an Xlet to achieve such a state is reliant on aspects outside of the scope of the conformance test 
itself (delivery bit rate, hardware and CPU capabilities of the test-client, etc.). 

Messages sent using this method should "atomic", i.e. that they are not interleaved with other 
messages sent using the methods defined in the DVBTest class. 

Implementation 

The precise mechanism(s) by which the this method may be implemented are intentionally 
unspecified. Implementation options for sending the prompt might include: 

• logging the controlCode via an RS-232 (or other serial) connection. 

• logging the controlCode to a remote host via some IP / UDP based mechanism, e.g. using a socket-based 
connection. 

• displaying the message on-screen for a (human) test operator, e.g. for systems not implementing a return 
channel capability. 

Implementation options for receiving the acknowledgement might include: 

• acknowledgement via an RS-232 (or other serial) connection. 

• acknowledgement from a remote host via some IP / UDP based mechanism, e.g. using a socket-based con- 
nection. 

• a (human) test operator manually acknowledging the message, e.g. for systems not implementing a return 
channel capability. 

Parameters: 

id - a string identifying the application (thread) that is sending the prompt. 

controlCode - an integer value (unique within a given Xlet) intended for use by some 
automated test process (corresponding to the readable message). 

message - a message (unique within a given Xlet) intended to be readable by a (human) test 
operator (corresponding to the automated controlCode). 

Throws: 

j ava . io . lOException - If there is any problem in receiving a positive acknowledgement from 
the test-server, then an this shall be thrown. This may be due to a negative acknowledgement 
from the test-server, or due to other communication based causes — which are deliberately left 
unspecified. 
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terminate(String, int) 

public static void terminate (j ava . lang . String id, int terminationCondition) 
throws lOException 

This synchronous, blocking, method logs the termination condition of a test application using write- 
only access. The method takes both an identifier string, e.g. "Test number 1" and a integer value to 
output, e.g. org.dvb.test.DVBTest.PASS. In addition to logging the termination condition of the test, 
invoking this method also indicates that the test application has terminated its operation. Note that 
termination of operation does not necessarily correspond to the application being in any particular 
lifecycle state (as defined in the "Application Model" chapter of the MHP specification). The 
application is not required to open a file or network connection, per se, and the terminate() method is 
always available for writing (in principle). 

The precise format of the termination message is left deliberately unspecified, implementers may 
choose to output compressed messages, XML documents, or other formats of their choice 
(obviously provided that the original information can be recovered). It is an implementation option to 
include additional information with each termination message, e.g. including: 

• version of the specification being implemented 

• compiler version and options. 

• build-version 

• timestamp 

• date 

• debug info 

On test-clients whose implementation of the terminate() method supports external communication to 
its test-server, implementations of this method may optionally indicate to the test-server that the test- 
client can be reset by its test-server so that another test may be initiated. The precise mechanism by 
which this communication takes place is not specified it may be via a IP / socket, serial port, etc. 

In the case of an test-client that does not support communication to its test-server, or in the case of 
an unsuccessful (hanging) test, or inability of this method to return (without throwing an exception) 
the test-server must be prepared to "time out" the application running on the test-client and then 
reset the test-client. 

Implementation 

The precise mechanism(s) by which the this method may be implemented are intentionally 
unspecified, implementation options might include: 

• storing the termination condition to a local file system. 

• storing the termination condition to a mounted remote file system. 

• storing the termination condition to a RAM disk, etc. 

• storing the termination condition via an RS-232 (or other serial) connection. 

• storing the termination condition to a remote host via some IP / UDP based mechanism, e.g. using a 
socket-based connection. 

Messages sent using this method should "atomic", i.e. that they are not interleaved with other 
messages sent using the methods defined in the DVBTest class. 

Note that the implementation of the terminate method may use the same or a different mechanism to 
that used by the log method. 

The terminate method does not require any explicit initialisation on the part of the application under 
test. For example if termination conditions are being stored to a file system, then the application is 
not required to mount / open any storage file. Similarly, if the results are being logged via a network 
connection, then the application is not required to open a connection to the storage host, etc. In 
principle, the mechanism should always be available to accept termination messages. 

If this method is implemented on top of some buffering mechanism, it is strongly recommended that 
the buffer be flushed for each occurrence of a message being logged. 
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Security and implementation options 

There is no Java security mecinanism tinat is used to secure tine terminate metlnod. 

Note tiiat even if tine terminate metinods is based on a particular implementation option, it shall be 
able to operate in spite of that particular implementation option itself being subject to security 
checks. For example, a terminate method implemented using the Java. net.Socket class shall always 
be able to log the termination condition of a test-application, even if the test-application is unable to 
directly access the Java. net. Socket class due to security restrictions, etc. 

It is an allowed implementation option to require that the test-client be put into some particular "test- 
mode" before any test-results are logged. This mechanism is required to reduce any inadvertent 
interaction due to downloaded applications accessing the test methods. 

Autlioring guidelines 

The terminate method is not intended to be accessed by downloaded applications directly, it is purely 
intended for the use of conformance test applications. Authors of downloaded applications should 
not call this method, since there may be interactions between this method and normal in-field 
operation of the test-client (MHP platform). 

It is an allowed implementation option to require that the test-client be put into some particular "test- 
mode" before any test-results are logged. This mechanism is required to reduce any inadvertent 
interaction due to downloaded applications accessing the test methods. 

It is an allowed implementation option to have a number of "test-modes" that are appropriate to 
different elements being conformance tested, for example, it is a valid implementation for a test-client 
to have a test-mode where results are stored via a serial port, and a separate test-mode where 
results are stored via a RAM disk. It is allowable for a conformance test to be performed with the test- 
client in some specific test- mode, e.g. a java.net test (using a serial modem) might have its test 
results logged to a RAM disk, to avoid interaction between test-log messages and the serial protocol. 

The mechanism by which a test-client is put into a given test mode is intentionally left unspecified. 

Relationship to java.io 

It is an implementation option to map the implementation of this method onto corresponding write 
method(s) of appropriate java.io classes. These classes may in turn be obtained, e.g. from java.net 
Socket classes, etc. 

Parameters: 

id - a string identifying the application (thread) that is terminating the test. 

terminationCondition - the termination condition of the test application. 

Throws: 

j ava . io . lOException - thrown if there is any problem in terminating an application. This may 
be due to failure to write to a file system, inability to access a remote socket, etc. the precise 
causes are deliberately unspecified. 
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AnnexY (normative): Inter-application communication 
API 
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Package 

org.dvb.io.ixc 



Description 

Provides support for inter- application communication. 



Class Summary 


Classes 

IxcRegistry 


This is the bootstrap mechanism for obtaining references to remote objects 
residing in other Xlets executing on the same IVIHP terminal, using a URL-like 
syntax. 
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org.dvb.io.ixc 

IxcRegistry 

Declaration 

public class IxcRegistry 
Java . lang .Object 

+ — org . dvb . io . ixc . IxcRegistry 

Description 

This is the bootstrap mechanism for obtaining references to remote objects residing in other Xlets executing on the 
same MHP terminal, using a URL-like syntax. The identification of a remote object is given using a syntax 
indicating the organisation ID and application ID: 

/organisation_id/application_id/name 

organisation_id = the organisation ID of the Xlet, as signalled in the application_identifier record, defined in the 
MHP specification. 

application_id = the application ID of the Xlet, as signalled in the application_identifier record, defined in the 
MHP specification. 

name = the name under which the remote object was exported. 

The organisation ID and the application ID shall each be encoded as a hexadecimal string, as would be accepted by 
java.lang.Integer.parseInt(String s, 16). 

When RMI is used to communicate over a network, stubs generated by a tool like rmic are often required. This is 
not necessary for inter-xlet communication initiated with IxcRegistry. If such stubs are present, they shall be 
ignored. 

Similarly, network RMI objects often extend the class server.RemoteObject, in order to get appropriate 
implementations for Object.hashCode(), Object.equals(), and Object.toString(). Overriding Object's 
implementation of these methods in this way is not necessary for inter-xlet communication initiated with 
IxcRegistry, although it is not harmful. Note that the class server.RemoteObject is not required in all MHP profiles. 

Methods 



bind(XletContext, String, Remote) 

public static void bind (javax . tv . xlet . XletContext xc, j ava . lang. String name, 
j ava . rmi .Remote obj) 
throws AlreadyBoundException 

Exports an object under a given name in tine namespace of an Xlet. Tine name can be any valid non- 
null String. No hierarchical namespace exists, e.g. the names "foo" and "bar/. ./too" are distinct. If the 
exporting xlet has been destroyed, this method may fail silently. 

Parameters: 

xc - The context of the Xlet exporting the object. 

name - The name identifying the object. 
obj - The object being exported 

Throws: 

Java, rmi .AlreadyBoundException - if this Xlet has previously exported an object under 
the given name. 

NullPointerException - if xc, name or obj is null 
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list(XletContext) 

public static j ava . lang. String[ ] list { j avax . tv. xlet . XletContext xc) 

Returns an array of string path objects available in the registry. The array contains a snapshot of the 
names present in the registry that the current Xlet would be allowed to import using 
IxcRegistry. lookup. 

Parameters: 

xc - The context of the current Xlet. 

Returns: 

A non-null array of strings containing a snapshot of the path names of all objects available to the 
caller in this registry. 

See Also: 

lookup (XletContext, String) 



lookup(XletContext, String) 

public static j ava . rmi . Remote lookup (j avax . tv. xlet . XletContext xc, Java . lang . String path) 
throws NotBoundException, RemoteException 

Returns a remote object previously exported by an Xlet that has not been destroyed. The 

identification of a remote object is given using a syntax indicating the organisation ID and application 

ID: 

/organisation_id/application_id/name 

organisation_id = the organisation ID of the Xlet, as signalled in the application_identifier record. 

application_id = the application ID of the Xlet, as signalled in the application_identifier record. 

name = the name under which the remote object was exported. 

The organisation ID and the application ID shall each be encoded as a hexadecimal string, as would 
be accepted by Java. lang. lnteger.parselnt(String s, 16). If the caller is not authorized to import a 
given object due to the security policy, then this API will behave as though the object had not been 
exported, that is, a NotBoundException shall be thrown. 

Parameters: 

xc - The context of the current Xlet (that is, the Xlet importing the object). 

path - A file pathname-like string identifying the Xlet and the name of the object to be imported. 

Returns: 

A remote object 

Throws: 

j ava . rmi . NotBoundException - If the path is not currently bound. 

j ava . rmi . RemoteException - If a remote stub class cannot be generated for the object 
being imported. 

Java. lang. lllegalArgumentException - If the path is not formatted in the syntax given 
above. 

NullPointerException - if path is null 



rebind(XletContext, String, Remote) 

public static void rebind (j avax . tv. xlet .XletContext xc, Java . lang . String name, 
j ava . rmi . Remote obj) 

Rebind the name to a new object in the context of an Xlet; replaces any existing binding. The name 
can be any valid non-null String. No hierarchical namespace exists, e.g. the names "foo" and "bar/../ 
foo" are distinct. If the exporting xlet has been destroyed, this method may fail silently. 
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Parameters: 

xc - The context of the Xlet that exported the object. 

name - The name identifying the object. 
ob j - The object being exported 

Throws: 

NullPointerException - if xc, name or obj is null 



unbind(XletContext, String) 

public static void unbind (j avax . tv. xlet .XletContext xc, Java . lang . String name) 
throws NotBoundException 

Unbind the name. 

Parameters: 

xc - The context of the Xlet that exported the object to be unbound. 

name - The name identifying the object. 

Throws: 

j ava . rmi . NotBoundException - if this is not currently any object exported by this Xlet under 
the given name. 

NullPointerException - if xc or name is null 
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Annex Z (informative):Services, Service Contexts and 

Applications in an MHP Environment 

Z.1 Introduction 

This document describes the concepts that link the various parts of an MHP execution environment so that it can display 
a complete MHP service, including media and applications. This is really an overview to the MHP application lifecycle 
model, but does include some additional information. 

We assume some familiarity with MHP and the JavaTV specification. 

Z.2 Basic concepts 

The unit for the presentation and execution of content in the MHP specification is the service. A service in MHP 
represents a group of pieces of content which are intended to be presented together to the end-user. In this version of the 
specification, the service is the contents of a broadcast DVB service, including audio/video streams, data streams and all 
the service information, applications and application signalling that is being broadcast. The current service will largely 
be responsible for determining what media and applications are presented to the user. 

Every service that gets presented by an MHP platform is presented within a service context. These form one of the 
foundations for the runtime environment and the execution model. A service context is an "environment" in which a 
service gets presented - it defines the boundaries of the service (letting the platform and applications identify which of 
the pieces of content that are being presented make up a given service). It also enables that service to be addressed and 
controlled as a single entity. A DVB-J application can call the select method on a service context (represented by javax.tv. 
service. selection.ServiceContext) and the platform will stop presenting all of the content that makes up the current 
service being presented by that service context and start presenting the content that makes up the new service. In this 
case, "content" may include one or more applications. 

A service context has some major differences from a DVB-J Xlet context. It is not necessary to have one service context 
for every possible service that can or will get presented - one service context is needed for every service that can be 
presented simultaneously, but that is all. Also, a service context is not destroyed when the service within it is stopped, 
unlike the Xlet context for a DVB-J application. The service context exists until an application or the platform explicitly 
destroys it. In normal operational mode, the built-in navigator or EPG for an MHP system will create one single service 
context when it starts and never destroy that. MHP applications will run in that service context. 



Z.3 Presenting a service in IVIHP 



From the MHP point of view, the content of a service can be one of two types - media or applications. Media is the 
simplest case and is described first. 

Z.3.1 Presenting the media components of a service 

If there are several different streams of media that may get presented (such as several different video streams) then the 
platform uses a variety of methods to tell which streams should be used. These include user preferences and platform 
defaults, but will also include using service information do determine which streams get presented to the user. 

For a DVB-J application, all real-time media components sharing the same clock are presented by the same JMF player. 
These players are directly linked to the service context, and the service context can be queried to find out which JMF 
Players are linked with it. It is also possible for applications to create JMF Player objects directly without linkage to the 
applications service context. 

Z.3. 2 Presenting tine application components of a service 

Applications are handled in a slightly different way. The lifecycle of all applications in an MHP environment is 
controlled by an application manager, a software entity that forms part of the MHP runtime environment. It takes its 
instructions on which applications to start and stop from the user, but also from information that is included in the MHP 
broadcast (called an "AIT", can logically be considered an extension to MPEG's PMT) and the free resources in the 
platform. 
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The information carried in the AIT (Application Information Table) not only says which applications are available, but 
also provides some instructions to the application manager about whether an application should be started automatically 
or whether an application should be killed automatically. The application manager monitors this information for changes, 
and creates, starts or kills applications as appropriate. 

Every DVB-J application executes within an Xlet context. This is a similar concept to the applet context that a Java applet 
executes in, and it provides the Xlet with a link to its environment, both for accessing system properties and for telling 
the environment that the Xlet has changed its own state. 

Since every Xlet executes as part of a DVB service, there is also a link between the Xlet and its associated service. This 
link is the class javax.tv.service.selection.ServiceContextFactory. Using methods on this class, an Xlet can lookup its 
service context from its xlet context. From the service context, an Xlet can discover which service it is current running as 
part of. It can also register for events to be told when the service being presented in its service context changes. 

The application manager must maintain a list of all the applications in a system, so that it knows which ones are currently 
executing. It must also know (directly or indirectly) which applications are associated with which service context, so that 
if the service being presented in that service context changes due to a new service being selected, it can kill the 

applications that are not signalled in the new service. When a service is selected in a service context, the following steps 
happen in approximately this order: 

a) The platform examines the MPEG PMT for the service that has been selected (tuning first if necessary) and works 
out which media streams are to be presented. 

b) Any media streams currently playing are stopped and any new media streams that need to be presented 
are started. Any JMF players presenting the old content are stopped and destroyed, and players for the 
new content are created and started if necessary. 

c) The platform monitors the application information table for the new service to find out which 
applications should be running. Any applications that are currently running but which are not signalled 
in the application information table of the new service (or which are signalled as killed) are killed and 
the Xlet contexts of DVB-J applications associated with the old service are destroyed. 

d) For any apphcations which are signalled as autostart and are not currently running, the following steps 
are taken: 

• The platform attaches to the object carousel signalled in the application information table 

• The platform attempts to load the main application file as signalled in the application information table 

• For a DVB-J application, the platform creates an instance of the main class using the default 
constructor, creates an XletContext object for the application and calls the Xlet.initXlet() method on the 
newly loaded class, passing the XletContext object as a parameter. Once this call is complete, the 
platform calls the Xlet.startXlet() method. 

If several applications are signalled as autostart, the platform will load and start every one in the same way. Each DVB-J 
application will have a different Xlet context and will execute independently, although they are all associated with the 
same service context. 

Z.4 Multiple service contexts in an MHP platform 

The MHP specification allows the platform to have any number of service contexts, although the platform may choose to 
limit the number it can produce, possibly even to one. Each service context can present a different service, completely 
independently of the other service contexts. Operations carried out on one service context will not affect another (unless 
they cause tuning which prevents the contents of a service in another service context from being presented). It is even 
possible to display the same service in several service contexts simultaneously - this may not be very useful, but it is 
allowed. This may result in several instances of the same application running in at the same time in different service 
contexts. In practice, this is most likely to happen in future MHP terminals with multiple independent video output 
charmels. 
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Z.5 How does the platform know which services are 
available? 

In order to select a new service, an application (or the platform) has to know three things about the service it wants to 
start: the original network ID, the transport stream ID and the service ID for the service in question. In the case of an 
application, those values may be hard-wired into the application by the developer, but this not required. The application 
can find out about a service in the same way that the platform can - using service information. 

The platform can not know the details of every available service when it started for the first time, and so it 
must use another method to find out about what services it can receive. A set-top box may do the following to 
find this out, for instance: 

a) Scan the input (satellite, cable or some other input) to find out which transport streams are available and the 
physical parameters it needs to tune to them successfiilly. 

b) For every transport stream: 

• Tune to it 

• Use the service information API to access the service description table (SDT) and network information table 
(NIT) for that transport stream. 

• Use these tables to find what services are in the transport stream and the values needed to select those services 

• In the case of the platform performing an initial scan, write this information to non- volatile memory 

c) When the application has found the service it wants (or in the case of the platform performing a scan, once every 
transport stream has been scanned in this way), a service can be selected. 

At this point, the platform has all the information it needs to start presenting services to the user. It is important to realise 
that this is not the only way of finding this information - other ways may be possible, depending on the MHP 
implementation. 
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of org.dvb.test 736 
DVBTextLayoutManager 

of org.dvb.ui 712 
DVBTextLayoutManager() 

of org.dvb.ui. DVBTextLayoutManager 714 
DVBTextLayoutManager(int, int, int, int, boolean, int, int, int) 

of org.dvb.ui.DVBTextLayoutManager 714 

E 

entry Added(AppsDatabaseEvent) 

of org.dvb. application. AppsDatabaseEventListener 665 
entryChanged(AppsDatabaseEvent) 

of org.dvb. application. AppsDatabaseEventListener 665 
entryRemoved(AppsDatabaseEvent) 

of org.dvb. application. AppsDatabaseEventListener 665 
equals(Object) 

of org.dvb. application. AppID 651 

of org.dvb. application.AppsControlPermission 658 

of org.dvb.ui. DVBAlphaComposite 693 
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of org.dvb.ui.DVBColor 705 
EventManager 

of org.dvb.event 372 
EventManager() 

of org.dvb.event.EventManager 372 
EXTENDED_EVENT 

of org.dvb.si.DescriptorTag 417 



Facility 

of org.dvb.user 398 
Facility(String, String) 

of org.dvb.user.Facility 398 
Facility(String, String[]) 

of org.dvb.user.Facility 398 
FAIL 

of org.dvb.test.DVBTest 736 
feed(byte[]) 

of org.dvb.media.DripFeedDataSource 506 
FileAccessPermissions 

of org.dvb.io.persistent 391 
FileAccessPermissions(boolean, boolean, boolean, boolean, boolean, boolean) 

of org.dvb.io.persistent.FileAccessPermissions 391 
FileAttributes 

of org.dvb.io.persistent 393 
fillBackground(Graphics, HVisible, int) - of org.havi.ui.HExtendedLook 290 
findClass(String) 

of org.dvb.lang.DVBClassLoader 366 
flushO 

of org.dvb.ui.DVBBufferedlmage 697 
FM_RADIO 

of org.dvb.si.SIServiceType 482 
FontFactory 

of org.dvb.ui719 
FontFactoryO 

of org.dvb.ui. FontFactory 719 
FontFactory(URL) 

of org.dvb.ui. FontFactory 719 
FontFormatException 

of org.dvb.ui 721 
FontFormatException() 

of org.dvb.ui. FontFormatException 721 
FontFormatException( String) 

of org.dvb.ui. FontFormatException 721 
FontNotAvailableException 

of org.dvb.ui 722 
FontNotAvailableException() 

of org.dvb.ui. FontNotAvailableException 722 
FontNotAvailableException(String) 

of org.dvb.ui. FontNotAvailableException 722 
FREQUENCY_LIST 

of org.dvb.si.DescriptorTag 417 
FROM_CACHE 

of org.dvb.dsmcc.DSMCCObject 557 



ETSI 



759 ETSITS 101 812V1.3.1 (2003-06) 



FROM_CACHE_ONLY 

of org.dvb.si.SIInformation 452 
FROM_CACHE_OR_STREAM 

of org.dvb.dsmcc.DSMCCObject 557 

of org.dvb.si.SIInformation 452 
FROM_STREAM_ONLY 

of org.dvb.dsmcc.DSMCCObject 557 

of org.dvb.si.SIInformation 452 
fromActualO 

of org.dvb.si.SIInformation 453 

G 

GeneralPreference 

of org.dvb.user 399 
GeneralPreference(String) 

of org.dvb.user. GeneralPreference 399 
getActionsO 

of org.dvb.appIication.AppsControlPermission 658 
getActiveFormatDefmition() 

of org.dvb.media. VideoFormatControl 528 
getActiveVideoAreaO 

of org.dvb.media. VideoPresentationControl 534 
getActiveVideoAreaOnScreen() 

of org.dvb.media. VideoPresentationControl 534 
getAIDO 

of org.dvb. application. AppID 652 
getAlphaO 

of org.dvb.ui.DVBAlphaComposite 693 

of org.dvb.ui.DVBColor 705 
getAppAttributes(AppID) 

of org.dvb. application.AppsDatabase 660 
getAppAttributes(AppsDatabaseFilter) 

of org.dvb. application. AppsDatabase 661 
getAppDataO 

of org.dvb. si. SIRetrievalEvent 472 
getAppIcon() 

of org.dvb. application. AppAttributes 645 
getAppIDO 

of org.dvb. application. AppsDatabaseEvent 664 

of org.dvb. application. AppStateChangeEvent 669 
getAppIDs(AppsDatabaseFilter) 

of org.dvb. application.AppsDatabase 661 
getAppProxy( AppID) 

of org.dvb. application.AppsDatabase 661 
getAppsDatabaseO 

of org.dvb. application. AppsDatabase 662 
getAspectRatioO 

of org.dvb.media. VideoFormatControl 529 
getAvailableCompositeRulesO 

of org.dvb.ui.DVBGraphics 708 
getBestColorMatch(Color) 

of org.dvb.ui.DVBGraphics 708 
getBouquetlDQ 

of org.dvb. si. SIBouquet 425 
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of org.dvb.si.SIMonitoringEvent 460 

of org.dvb.si.SITransportStreamB AT 490 
getByteAt(int) 

of org.dvb.si.Descriptor 414 
getCarouselldO 

of org.dvb.dsmcc.ServiceXFRReference 608 
getClientO 

of org.dvb.event.RepositoryDescriptor 376 

of org.dvb.net.rc.ConnectionRCInterface 627 
getClipRegion() 

of org.dvb.media. VideoPresentationControl 534 

of org.dvb.media. VideoTransformation 539 
getClosestMatch(VideoTransformation) 

of org.dvb.media.BackgroundVideoPresentationControl 500 
getCodeO 

of org.dvb.event.UserEvent 378 
getColor() 

of org.dvb.ui.DVBGraphics 708 
getComponentTagO 

of org.dvb.si.PMTElementaryStream 420 
getConnectedTimeO 

of org.dvb.net.rc.ConnectionRCInterface 627 
getContent() 

of org.dvb.si.Descriptor 415 
getContentLength() 

of org.dvb.si.Descriptor 415 
getContentNibblesQ 

of org.dvb.si.SIEvent 446 
getContentTypeO 

of org.dvb.media.DripFeedDataSource 506 
getControl(String) 

of org.dvb.media.DripFeedDataSource 506 
getControlsQ 

of org.dvb.media.DripFeedDataSource 507 
getCurrentTarget() 

of org.dvb.net.rc.ConnectionRCInterface 628 
getDataRateO 

of org.dvb.net.rc.RCInterface 634 
getDataSourceO 

of org.dvb.si.SIInformation 453 
getDecoderFormatConversion() 

of org.dvb.media. VideoFormatControl 529 
getDenominator() 

of org.dvb.dsmcc.NPTRate 590 
getDescriptorTagsO 

of org.dvb.si.SIBouquet 425 

of org.dvb.si.SIInformation 453 

of org.dvb.si.SINetwork 464 
getDisplayAspectRatioO 

of org.dvb.media. VideoFormatControl 529 
getDNSServerO 

of org.dvb.net.rc.ConnectionParameters 624 
getDuration() 

of org.dvb.dsmcc.DSMCCStream 565 

of org.dvb.media.DripFeedDataSource 507 
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of org.dvb.si.SIEvent 446 
getDVBCompositeO 

of org.dvb.ui.DVBGraphics 709 
getDvbLocator() 

of org.dvb.si.PMTElementaryStream 420 

of org.dvb.si.PMTService 422 

of org.dvb.si.SIEvent 447 

of org.dvb.si.SIService 476 

of org.dvb.si.SITransportStream 488 
getEITPresentFoUowingFlagO 

of org.dvb.si.SIService 476 
getEITScheduleFlagO 

of org.dvb.si.SIService 476 
getElementaryPID() 

of org.dvb.si.PMTElementaryStream 420 
getElementaryStreams() - of org.davic.mpeg.NotAuthorizedException 245 
getEndTimeO 

of org.dvb.si.SIMonitoringEvent 460 
getEventDataO 

of org.dvb.dsmcc.StreamEvent 610 
getEventlDO 

of org.dvb.si.SIEvent 447 
getEventldO 

of org.dvb.application. AppsDatabaseEvent 664 

of org.dvb.dsmcc.StreamEvent 611 
getEventList() 

of org.dvb.dsmcc.DSMCCStreamEvent 569 
getEventNameO 

of org.dvb.dsmcc.StreamEvent 611 
getEventNPTO 

of org.dvb.dsmcc.StreamEvent 611 
getExpirationDateO 

of org.dvb.io.persistentFileAttributes 393 
getFamilyO 

of org.dvb.event.UserEvent 378 
getFavouritesO 

of org.dvb.user.Preference 401 
getFileAttributes(File) 

of org.dvb.io.persistent.FileAttributes 394 
getFirstNPTO 

of org.dvb.dsmcc.NPTDiscontinuityEvent 587 
getFreeCAModeO 

of org.dvb.si.SIEvent 447 

of org.dvb.si.SIService 476 
getFromStateO 

of org.dvb.application. AppStateChangeEvent 669 
getGraphicsO 

of org.dvb.ui.DVBBufferedlmage 697 
getHeightO 

of org.dvb.ui.DVBBufferedlmage 697 
getHeight(ImageObserver) 

of org.dvb.ui.DVBBufferedlmage 697 
getHorizontalAlign() 

of org.dvb.ui.DVBTextLayoutManager 714 
getHorizontalScalingFactorsO 
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of org.dvb.media. VideoPresentationControl 535 
getHorizontalTabSpacingO 

of org.dvb.ui.DVBTextLayoutManager 715 
getlconFlagsO 

of org.dvb. application. Applcon 650 
getldentifier() 

of org.dvb. application. AppAttributes 646 
getlmageO 

of org.dvb.ui.DVBBufferedlmage 698 
getlnputVideoSizeO 

of org.dvb.media. VideoPresentationControl 535 
getlnsetsO 

of org.dvb.ui.DVBTextLayoutManager 715 
getlnstanceO 

of org.dvb.event.EventManager 374 

of org.dvb.net.rc.RCInterfaceManager 636 

of org.dvb.user.UserPreferenceManager 407 
getlnstance(int) 

of org.dvb.ui.DVBAlphaComposite 693 
getlnstance(int, float) 

of org.dvb.ui.DVBAlphaComposite 693 
getlnterface(InetAddress) 

of org.dvb.net.rc.RCInterfaceManager 636 
getlnterface(Socket) 

of org.dvb.net.rc.RCInterfaceManager 637 
getlnterface(URLConnection) 

of org.dvb.net.rc.RCInterfaceManager 637 
getlnterfacesO 

of org.dvb.net.rc.RCInterfaceManager 637 
getis S erviceBoundO 

of org.dvb. application.AppAttributes 646 
getKeyChar() 

of org.dvb.event.UserEvent 378 
getLastNPTO 

of org.dvb.dsmcc.NPTDiscontinuityEvent 587 
getLetterSpaceO 

of org.dvb.ui.DVBTextLayoutManager 715 
getLevell ContentNibbles() 

of org.dvb. si. SIEvent 447 
getLineOrientation() 

of org.dvb.ui.DVBTextLayoutManager 715 
getLineSpaceO 

of org.dvb.ui.DVBTextLayoutManager 715 
getLocator() 

of org.dvb. application. Applcon 650 

of org.dvb.dsmcc.ServiceDomain 601 

of org.dvb.dsmcc.ServiceXFRReference 609 
getModifiersO 

of org.dvb.event.UserEvent 378 
getMostFavouriteO 

of org.dvb.user.Preference 401 
getMountPointO 

of org.dvb.dsmcc.ServiceDomain 602 
getNameO 

of org.dvb. application. AppAttributes 646 
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of org.dvb.event.RepositoryDescriptor 376 

of org.dvb.si.SIBouquet 426 

of org.dvb.si.SIEvent 447 

of org.dvb.si.SINetwork 464 

of org.dvb.si.SIService 477 

of org.dvb.user.Preference 402 

of org.dvb.user.UserPreferenceChangeEvent 405 
getName(String) 

of org.dvb. application. AppAttributes 646 
getNamesO 

of org.dvb. application. AppAttributes 647 
getNetworkID() 

of org.dvb. si. SIMonitoringEvent 460 

of org.dvb.si.SINetwork 465 

of org.dvb. si. SITransportStreamNIT 492 
getNetworklnterface(SIDatabase) 

of org.dvb.net.tuning.DvbNetworklnterfaceSIUtil 684 
getNewDFCO 

of org.dvb.media.DFCChangedEvent 504 
getNewFormat() 

of org.dvb.media. ActiveFormatDescriptionChangedEvent 498 
getNewRatioO 

of org.dvb.media. AspectRatioChangedEvent 499 
getNewVersionNumber() 

of org.dvb.dsmcc.ObjectChangeEvent 594 
getNPTO 

of org.dvb.dsmcc.DSMCCStream 565 
getNPTRateO 

of org.dvb.dsmcc.DSMCCStream 566 
getNSAPAddressO 

of org.dvb.dsmcc.ServiceDomain 602 

of org.dvb.dsmcc.ServiceXFRReference 609 
getNumerator() 

of org.dvb.dsmcc.NPTRate 590 
getOIDO 

of org.dvb. application. AppID 652 
getOriginalNetworkID () 

of org.dvb. si.PMTElementaryStream 421 

of org.dvb. si.PMTService 422 

of org.dvb.si.SIEvent 447 

of org.dvb. si. SIMonitoringEvent 460 

of org.dvb.si.SIService 477 

of org.dvb. si. SITransportStream 488 
getPasswordO 

of org.dvb.net.rc.ConnectionParameters 624 
getPathNameO 

of org.dvb.dsmcc.ServiceXFRReference 609 
getPcrPidO 

of org.dvb. si.PMTService 422 
getPermissionsQ 

of org.dvb.io.persistent.FileAttributes 394 
getPosition( String) 

of org.dvb.user.Preference 402 
getPositioningCapabilityO 

of org.dvb.media. VideoPresentationControl 535 
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jetPriorityO 

of org.dvb.application.AppAttributes 647 

of org.dvb.io.persistent.FileAttributes 394 
jetProfilesQ 

of org.dvb. application. AppAttributes 647 
jetProperty(String) 

of org.dvb.application. AppAttributes 647 
jetProperty(String, ImageObserver) 

of org.dvb.ui.DVBBufferedlmage 698 
jetProviderNameO 

of org.dvb. si. SIService 477 
jetRateO 

of org.dvb.dsmcc.NPTRateChangeEvent 591 
jetReason() 

of org.dvb.media.PresentationChangedEvent 514 
jetReason(int) - of org.davic.mpeg.NotAuthorizedException246 
jetReceiveBufferSize(DatagramSocket) 

of org.dvb.net.DatagramSocketBufferControl 617 
jetResultO 

of org.dvb. si. SISuccessfulRetrieveEvent 484 
jetRGBO 

of org.dvb.ui.DVBColor 706 
jetRGB(int, int) 

of org.dvb.ui.DVBBufferedlmage 698 
jetRGB(int, int, int, int, int[], int, int) 

of org.dvb.ui.DVBBufferedlmage 699 
jetRuleO 

of org.dvb.ui.DVBAlphaComposite 694 
jetRunningStatusO 

of org.dvb. si. SIEvent 448 

of org.dvb. si.SIService 477 
jetScaledInstance(int, int, int) 

of org.dvb.ui.DVBBufferedlmage 699 
jetScalingFactorsO 

of org.dvb.media. VideoTransformation 539 
jetServiceO - of org.davic.mpeg.NotAuthorizedException 246 
jetServicelDQ 

of org.dvb. si.PMTElementaryStream 421 

of org.dvb. si.PMTService 422 

of org.dvb. si. SIEvent 448 

of org.dvb. si. SIMonitoringEvent 460 

of org.dvb. si. SIService 477 
jetServiceLocator() 

of org.dvb.application. AppAttributes 648 
jetServiceXFRO 

of org.dvb.dsmcc.ServiceXFRErrorEvent 604 

of org.dvb.dsmcc.ServiceXFRException 607 
jetSetupTimeEstimateO 

of org.dvb.net.rc.ConnectionRCInterface 628 
jetSliortBouquetNameO 

of org.dvb. si. SIBouquet 426 
jetSliortDescription() 

of org.dvb. si. SIEvent 448 
jetSliortEventName() 

of org.dvb. si. SIEvent 448 
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getShortNetworkName() 

of org.dvb.si.SINetwork 465 

getShortProviderNameO 

of org.dvb.si.SIService 478 

getShortServiceNameO 

of org.dvb.si.SIService 478 

getSIDatabaseO 

of org.dvb.si.SIDatabase 433 
of org.dvb.si.SIInformation 453 

getSIDatabase(Networklnterface) 

of org.dvb.net.tuning.DvbNetworklnterfaceSIUtil 684 

getSignersO 

of org.dvb.dsmcc.DSMCCObject 559 

getSigners(boolean) 

of org.dvb.dsmcc.DSMCCObject 559 

getSIInformationTypeO 

of org.dvb.si.SIMonitoringEvent 461 

getSIServiceLocatorsQ 

of org.dvb.si.SIBouquet 426 

getSIServiceTypeO 

of org.dvb.si.SIService 478 

getSourceO 

of org.davic.mpeg.sections.TimeOutEvent 249 

of org.dvb.dsmcc.AsynchronousLoadingEvent 553 

of org.dvb.dsmcc.InsufficientResourcesEvent 572 

of org.dvb.dsmcc.InvalidFormatEvent 575 

of org.dvb.dsmcc.InvalidPathnameEvent 577 

of org.dvb.dsmcc.LoadingAbortedEvent 579 

of org.dvb.dsmcc.MFEGDeliveryErrorEvent 580 

of org.dvb.dsmcc.NotEntitledEvent 582 

of org.dvb.dsmcc.NPTRateChangeEvent 591 

of org.dvb.dsmcc.NPTStatusEvent 593 

of org.dvb.dsmcc.ObjectChangeEvent 595 

of org.dvb.dsmcc.ServerDeliveryErrorEvent 597 

of org.dvb.dsmcc.ServiceXFRErrorEvent 605 

of org.dvb.dsmcc.StreamEvent 611 

of org.dvb.dsmcc.SuccessEvent 613 

of org.dvb.event.UserEventAvailableEvent 382 

of org.dvb.event.UserEventUnavailableEvent 388 

of org.dvb.media.SubtitleAvailableEvent 519 

of org.dvb.media.SubtitleNotAvailableEvent 521 

of org.dvb.media.SubtitleNotSelectedEvent 522 

of org.dvb.media.SubtitleSelectedEvent 523 

of org.dvb.net.rc.RCInterfaceReleasedEvent 638 

of org.dvb.net.rc.RCInterfaceReservedEvent 639 

of org.dvb.si.SIMonitoringEvent 461 

of org.dvb.si.SIRetrievalEvent 473 

of org.dvb.ui.DVBBufferedlmage 700 

getStartComer() 

of org.dvb.ui.DVBTextLayoutManager 715 

getStartTimeO 

of org.dvb.si.SIEvent 448 

of org.dvb.si.SIMonitoringEvent 461 

getStateO 

of org.dvb. application. AppProxy 654 



ETSI 



766 



ETSITS 101 812V1.3.1 (2003-06) 



getStream() 

of org.dvb.media.CAStopEvent 503 

of org.dvb.media.NoComponentSelectedEvent 512 

of org.dvb.media.PresentationChangedEvent 514 

of org.dvb.media.ServiceRemovedEvent 516 

of org.dvb.media.StopByResourceLossEvent 518 
getStreamLocator() 

of org.dvb.dsmcc.DSMCCStream 566 
getStreamTypeO 

of org.dvb.si.PMTElementaryStream 421 
getSubimage(int, int, int, int) 

of org.dvb.ui.DVBBufferedlmage 700 
getTagO 

of org.dvb.si.Descriptor 415 
getTargetO 

of org.dvb.net.rc.ConnectionParameters 624 
getTextualServiceldentifiersO 

of org.dvb.si.TextualServiceldentifierQuery 494 
getTextWrappingO 

of org.dvb.ui.DVBTextLayoutManager 716 
getToStateO 

of org.dvb. application. AppStateChangeEvent 669 
getTotalVideoAreaO 

of org.dvb.media. VideoPresentationControl 535 
getTotalVideoAreaOnScreen() 

of org.dvb.media. VideoPresentationControl 535 
getTransportStreamID() 

of org.dvb.si.PMTElementaryStream 421 

of org.dvb.si.PMTService 423 

of org.dvb. si. SIEvent 448 

of org.dvb. si. SIMonitoringEvent 461 

of org.dvb. si. SIService 478 

of org.dvb. si. SITransportStream 488 
getTypeO 

of org.dvb. application. AppAttributes 648 

of org.dvb.event.UserEvent 379 

of org.dvb.net.rc.RCInterface 635 

of org.dvb.ui.DVBGraphics 709 
getTypeO - of org.davic.mpeg.NotAuthorizedException246 
getUpdateTimeO 

of org.dvb. si. Sllnformation 454 
getURLO 

of org.dvb.dsmcc.DSMCCObject 560 
getURL(Locator) 

of org.dvb.dsmcc.ServiceDomain 602 
getUserEvent() 

of org.dvb.event.UserEventRepository 386 
getUsemameO 

of org.dvb.net.rc.ConnectionParameters 624 
getUTCTimeO 

of org.dvb. si. SITime 487 
getVersions(String) 

of org.dvb. application. AppAttributes 648 
getVerticalAlign() 

of org.dvb.ui.DVBTextLayoutManager 716 
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getVerticalScalingFactorsO 

of org.dvb.media. VideoPresentationControl 536 
getVideoPosition() 

of org.dvb.media. VideoTransformation 539 
getVideoSizeO 

of org.dvb.media. VideoPresentationControl 536 
getVideoTransformationO 

of org.dvb.media.BackgroundVideoPresentationControl 500 
getVideoTransformation(int) 

of org.dvb.media. VideoFormatControl 529 
getWhenO 

of org.dvb.event.UserEvent 379 
getWidthO 

of org.dvb.ui.DVBBufferedlmage 700 
getWidth(ImageObserver) 

of org.dvb.ui.DVBBufferedlmage 701 

H 

hasFailedO 

of org.dvb. application. AppStateChangeEvent 669 
hashCodeO 

of org.dvb. application. AppID 652 

of org.dvb. application. AppsControlPermission 658 
hasReadApplicationAccessRight() 

of org.dvb.io.persistent.FileAccessPermissions 391 
hasReadOrganisationAccessRight() 

of org.dvb.io.persistent.FileAccessPermissions 391 
hasReadWorldAccessRight() 

of org.dvb.io.persistent.FileAccessPermissions 392 
hasValueO 

of org.dvb.user.Preference 402 
hasWriteApplicationAccessRight() 

of org.dvb.io.persistent.FileAccessPermissions 392 
hasWriteOrganisationAccessRight() 

of org.dvb.io.persistent.FileAccessPermissions 392 
has Write WorldAccessRight() 

of org.dvb.io.persistent.FileAccessPermissions 392 
HExtendedLook - of org.havi.ui 290 
HORIZONTAL_CENTER 

of org.dvb.ui.DVBTextLayoutManager 712 
HORIZONTAL_END_ALIGN 

of org.dvb.ui.DVBTextLayoutManager 712 
HORIZONTAL_START_ALIGN 

of org.dvb.ui.DVBTextLayoutManager 712 
HUMANJNTERVENTION 

of org.dvb.test.DVBTest 736 



IllegalObj ectTypeException 

of org.dvb.dsmcc 571 
IllegalObj ectTypeException() 

of org.dvb.dsmcc.IUegalObjectTypeException 571 
IllegalObjectTypeException( String) 
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of org.dvb.dsmcc.IUegalObjectTypeException 571 
lUegalProfileParameterException 

of org.dvb. application 676 
IllegalProfileParameterExceptionO 

of org.dvb. application.IUegalProfileParameterException 676 
IllegalProfileParameterException( String) 

of org.dvb. application.IUegalProfileParameterException 676 
implies(Permission) 

of org.dvb. application.AppsControlPermission 658 

of org.dvb.media.DripFeedPermission 509 

of org.dvb.net.ca.CAPermission 682 

of org.dvb.net.rc.RCPermission 641 

of org.dvb.net.tuning.TunerPermission 686 
IncompleteTargetException 

of org.dvb.net.rc 631 
IncompleteTargetExceptionO 

of org.dvb.net.rc.IncompleteTargetException 631 
IncompleteTargetException( String) 

of org.dvb.net.rc.IncompleteTargetException 631 
init() 

of org.dvb. application.DVBJProxy 674 
InsufficientResourcesEvent 

of org.dvb.dsmcc 572 
InsufficientResourcesEvent(DSMCCObject) 

of org.dvb.dsmcc.InsufficientResourcesEvent 572 
InsufficientResourcesException 

of org.dvb.dsmcc 573 
InsufficientResourcesExceptionO 

of org.dvb.dsmcc.InsufficientResourcesException 573 
InsufficientResourcesException( String) 

of org.dvb.dsmcc.InsufficientResourcesException 573 
InvalidAddressException 

of org.dvb.dsmcc 574 
InvalidAddressExceptionO 

of org.dvb.dsmcc.InvalidAddressException 574 
InvalidAddressException(String) 

of org.dvb.dsmcc.InvalidAddressException 574 
InvalidFormatEvent 

of org.dvb.dsmcc 575 
InvalidFormatEvent(DSMCCObject) 

of org.dvb.dsmcc.InvalidFormatEvent 575 
InvalidFormatException 

of org.dvb.dsmcc 576 
InvalidFormatExceptionO 

of org.dvb.dsmcc.InvalidFormatException 576 
InvalidFormatException(String) 

of org.dvb.dsmcc.InvalidFormatException 576 
InvalidLocatorException - oforg.davic.net 252 

InvalidLocatorExceptionO - of org.davic.net.InvalidLocatorException 252 
InvalidLocatorException( String) - of org.davic.net.InvalidLocatorException 252 
InvalidPatlinameEvent 

of org.dvb.dsmcc 577 
InvalidPatlinameEvent(DSMCCObject) 

of org.dvb.dsmcc.InvalidPathnameEvent 577 
InvalidPathNameException 
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of org.dvb.dsmcc 578 
InvalidPathNameExceptionO 

of org.dvb.dsmcc.InvalidPathNameException 578 
InvalidPathNameException( String) 

of org.dvb.dsmcc.InvalidPathNameException 578 
isAltDown() 

of org.dvb.event.UserEvent 379 
isAttachedO 

of org.dvb.dsmcc. ServiceDomain 603 
isAudioO 

of org.dvb.dsmcc.DSMCCStream 566 
isAvailablelnCacheO 

of org.dvb.si.SIRequest 470 
isConnectedO 

of org.dvb.net.rc.ConnectionRCInterface 628 
isControlDown() 

of org.dvb.event.UserEvent 379 
isDataO 

of org.dvb.dsmcc.DSMCCStream 566 
isLoadedO 

of org.dvb.dsmcc.DSMCCObject 561 
isMetaDown() 

of org.dvb.event.UserEvent 380 
isMPEGProgramO 

of org.dvb.dsmcc.DSMCCStream 566 
isNetworkConnectionAvailableO 

of org.dvb.dsmcc. ServiceDomain 603 
isObjectKindKnown() 

of org.dvb.dsmcc.DSMCCObject 561 
isOpaqueO 

of org.dvb.ui.TestOpacity 723 
isPanAndScan() 

of org.dvb.media. VideoTransformation 539 
isPlatform() 

of org.dvb.media. VideoFormatControl 529 
isSliiftDownO 

of org.dvb.event.UserEvent 380 
isStartableO 

of org.dvb. application. AppAttributes 649 
isStream() 

of org.dvb.dsmcc.DSMCCObject 561 
isStreamEvent() 

of org.dvb.dsmcc.DSMCCObject 561 
isVideoQ 

of org.dvb.dsmcc.DSMCCStream 567 
isVisibleO 

of org.dvb. application. AppAttributes 649 
IxcRegistry 

of org.dvb.io.ixc 744 

K 

KILLED 

of org.dvb. application.DVBHTMLProxy 672 
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LanguageNotAvailableException 

of org.dvb. application 677 
LanguageNotAvailableException() 

of org.dvb. application.LanguageNotAvailableException 677 
LanguageNotAvailableException( String) 

of org.dvb. application.LanguageNotAvailableException 677 
LINE_ORIENTATION_HORIZONTAL 

of org.dvb.ui.DVBTextLayoutManager 712 
LINE_ORIENTATION_VERTICAL 

of org.dvb.ui.DVBTextLayoutManager 713 
LINKAGE 

of org.dvb. si.DescriptorTag 417 
list(XletContext) 

of org.dvb.io.ixc.IxcRegistry 745 
loadO 

of org.dvb. application.DVBJProxy 675 
loadDirectoryEntry(AsynchronousLoadingEventListener) 

of org.dvb.dsmcc.DSMCCObject 561 
LOADED 

of org.dvb. application.DVBJProxy 674 
LOADING 

of org.dvb. application.DVBHTMLProxy 672 
LoadingAbortedEvent 

of org.dvb.dsmcc 579 
LoadingAbortedEvent(DSMCCObject) 

of org.dvb.dsmcc.LoadingAbortedEvent 579 
LOCAL_TIME_OFFSET 

of org.dvb. si.DescriptorTag 417 
log(String, int) 

of org.dvb.test.DVBTest 737 
log(String, String) 

of org.dvb.test.DVBTest 737 
lookup(XletContext, String) 

of org.dvb.io.ixc.IxcRegistry 745 

M 

MHP_APPLICATION 

of org.dvb. si. SIServiceType 482 
MMIObject - of org.davic.net.ca259 
MOSAIC 

of org.dvb. si.DescriptorTag 417 

of org.dvb. si. SIServiceType 483 
MPEG1_AUDI0 

of org.dvb. si.PMTStreamType 424 
MPEG1_VIDE0 

of org.dvb. si.PMTStreamType 424 
MPEG2_AUDI0 

of org.dvb. si.PMTStreamType 424 
MPEG2_VIDE0 

of org.dvb.si.PMTStreamType 424 
MPEGDeliveryErrorEvent 

of org.dvb.dsmcc 580 
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MPEGDeliveryErrorEvent(DSMCCObject) 

of org.dvb.dsmcc.MPEGDeliveryErrorEvent 580 
MPEGDeliveryException 

of org.dvb.dsmcc 581 
MPEGDeliveryException() 

of org.dvb.dsmcc.MPEGDeliveryException 581 
MPEGDeliveryException( String) 

of org.dvb.dsmcc.MPEGDeliveryException 581 
MULTILINGUAL_BOUQUET_NAME 

of org.dvb.si.DescriptorTag 417 
MULTILINGUAL_COMPONENT 

of org.dvb.si.DescriptorTag 417 
MULTILINGUAL_NETWORK_NAME 

of org.dvb.si.DescriptorTag 417 
MULTILINGUAL_SERVICE_NAME 

of org.dvb.si.DescriptorTag 417 

N 

NETWORK 

of org.dvb.si.SIMonitoringType 463 
NETWORK_NAME 

of org.dvb.si.DescriptorTag 418 
NEW_DATABASE 

of org.dvb. application. AppsDatabaseEvent 664 
newDatabase(AppsDatabaseEvent) 

of org.dvb. application. AppsDatabaseEventListener 666 
newInstance(URL [] ) 

of org.dvb.lang.DVBClassLoader 366 
newInstance(URL[], ClassLoader) 

of org.dvb.lang.DVBClassLoader 366 
NoComponentSelectedEvent 

of org.dvb.media 511 
NoComponentSelectedEvent(Controller, int, int, int, MediaLocator) 

of org.dvb.media.NoComponentSelectedEvent 511 
NoFreeCapacityException - of org. davic.net. ca 258 

NoFreeCapacityException() - of org.davic.net.ca.NoFreeCapacityException 258 
NoFreeCapacityException( String) - of org.davic.net.ca.NoFreeCapacityException 258 
NOT_LOADED 

of org.dvb. application. AppProxy 653 
NOT_RUNNING 

of org.dvb. si. SIRunningStatus 475 
NotAuthorizedException - of org.davic.mpeg 245 

NotAuthorizedException() - of org.davic.mpeg.NotAuthorizedException 245 
NotAuthorizedException(String) - of org.davic.mpeg.NotAuthorizedException 245 

NotAuthorizedMediaException(ElementaryStream[], int[]) - of org.davic.media.NotAuthorizedMediaExcep- 
tion 250 

NotAuthorizedMediaException(Service, int) - of org.davic.media.NotAuthorizedMediaException251 
NotAuthorizedMediaException(Service, int, int) 

of org.davic.media.NotAuthorizedMediaException 251 
NotEntitledEvent 

of org.dvb.dsmcc 582 
NotEntitledEvent(DSMCCObject) 

of org.dvb.dsmcc.NotEntitledEvent 582 
NotEntitledException 
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of org.dvb.dsmcc 583 
NotEntitledException() 

of org.dvb.dsmcc.NotEntitledException 583 
NotEntitledException(String) 

of org.dvb.dsmcc.NotEntitledException 583 
NothingToAbortException 

of org.dvb.dsmcc 584 
NothingToAbortException() 

of org.dvb.dsmcc.NothingToAbortException 584 
NothmgToAbortException(String) 

of org.dvb.dsmcc.NothingToAbortException 584 
notifyTextOverflow(String, HVisible, boolean, boolean) 

of org.dvb.ui.TextOverflowListener 724 
NotLoadedException 

of org.dvb.dsmcc 585 
NotLoadedException() 

of org.dvb.dsmcc.NotLoadedException 585 
NotLoadedException(String) 

of org.dvb.dsmcc.NotLoadedException 585 
NPTDiscontinuityEvent 

of org.dvb.dsmcc 586 
NPTDiscontinuityEvent(DSMCCStream, long, long) 

of org.dvb.dsmcc.NPTDiscontinuityEvent 586 
NPTListener 

of org.dvb.dsmcc 588 
NPTPresentEvent 

of org.dvb.dsmcc 589 
NPTPresentEvent(DSMCCStream) 

of org.dvb.dsmcc.NPTPresentEvent 589 
NPTRate 

of org.dvb.dsmcc 590 
NPTRateChangeEvent 

of org.dvb.dsmcc 591 
NPTRateChangeEvent(DSMCCStream, NPTRate) 

of org.dvb.dsmcc.NPTRateChangeEvent 591 
NPTRemovedEvent 

of org.dvb.dsmcc 592 
NPTRemovedEvent(DSMCCStream) 

of org.dvb.dsmcc.NPTRemovedEvent 592 
NPTStatusEvent 

of org.dvb.dsmcc 593 
NPTStatusEvent(DSMCCStream) 

of org.dvb.dsmcc.NPTStatusEvent 593 
NTSC 

of org.dvb.si.SIServiceType 483 
numberOfRemainingObjectsO 

of org.dvb.si.SIIterator 457 
NVOD_REFERENCE 

of org.dvb.si.DescriptorTag 418 

of org.dvb.si.SIServiceType 483 
NVOD_TIME_SHIFTED 

of org.dvb.si.SIServiceType 483 
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o 

Obj ectChangeEvent 

of org.dvb.dsmcc 594 
Obj ectChangeEvent(D SMCCObj ect, int) 

of org.dvb.dsmcc. ObjectChangeEvent 594 
Obj ectChangeEventListener 

of org.dvb.dsmcc 596 
OPTION_UNSUPPORTED 

of org.dvb.test.DVBTest 736 
org.davic.net - package 252 
org. dvb. application 

package 643 
org.dvb.dsmcc 

package 55 1 
org.dvb. event 

package 371 
org.dvb. io.ixc 

package 743 
org.dvb. io.persistent 

package 390 
org.dvb. lang 

package 364 
org.dvb.media 

package 496 
org.dvb.net 

package 616 
org.dvb.net.ca 

package 680 
org.dvb.net.rc 

package 619 
org.dvb.net.tuning 

package 683 
org.dvb. si 

package 411 
org.dvb.test 

package 734 
org.dvb. ui 

package 688 
org.dvb. user 

package 397 
OverallRepository 

of org.dvb.event 375 
OverallRepositoryO 

of org.dvb.event.OverallRepository 375 
OverallRepository(String) 

of org.dvb.event.OverallRepository 375 



PAL 

of org.dvb. si. SIServiceType 483 
PARENTAL_RATING 

of org.dvb. si.DescriptorTag 418 
PARTIAL TRANSPORT STREAM 
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of org.dvb.si.DescriptorTag 418 
PASS 

of org.dvb.test.DVBTest 736 
pause() 

of org.dvb. application. AppProxy 654 
PAUSED 

of org.dvb.application. AppProxy 654 
PAUSING 

of org.dvb. si. SIRunningStatus 475 
PermissionDeniedException 

of org.dvb.net.rc 632 
PermissionDeniedException() 

of org.dvb.net.rc.PermissionDeniedException 632 
PermissionDeniedException(String) 

of org.dvb.net.rc.PermissionDeniedException 632 
PMT_SERVICE 

of org.dvb. si. SIMonitoringType 463 
PMTElementaryStream 

of org.dvb. si 420 
PMTService 

of org.dvb. si 422 
PMTStreamType 

of org.dvb. si 424 
POS_CAP_FULL 

of org.dvb.media. VideoPresentationControl 533 
POS_CAP_FULL_EVEN_LINES 

of org.dvb.media. VideoPresentationControl 533 
POS_CAP_FULL_EVEN_LINES_IF_ENTIRE_VIDEO_ON_SCREEN 

of org.dvb.media. VideoPresentationControl 533 
POS_CAP_FULL_IF_ENTIRE_VIDEO_ON_SCREEN 

of org.dvb.media. VideoPresentationControl 534 
POS_CAP_OTHER 

of org.dvb.media. VideoPresentationControl 534 
postMonitoringEvent(SIMonitoringEvent) 

of org.dvb. si. SIMonitoringListener 462 
postRetrievalEvent(SIRetrievalEvent) 

of org.dvb. si. SIRetrievalListener 474 
Preference 

of org.dvb.user 400 
Preference() 

of org.dvb.user.Preference 400 
Preference(String, String) 

of org.dvb.user.Preference 400 
Preference(String, String[]) 

of org.dvb.user.Preference 400 
prefetch() 

of org.dvb. application.DVBHTMLProxy 672 
prefetch(DSMCCObject, String, byte) 

of org.dvb.dsmcc.DSMCCObject 562 
prefetch(String, byte) 

of org.dvb.dsmcc.DSMCCObject 562 
PRESENT_FOLLOWING_EVENT 

of org.dvb. si. SIMonitoringType 463 
PresentationChangedEvent 

of org.dvb.media 513 
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PresentationChangedEvent(Controller, MediaLocator, int) 

of org.dvb.media.PresentationChangedEvent 514 
PRIORITY_HIGH 

of org.dvb.io.persistent.FileAttributes 393 
PRIORITY_LOW 

of org.dvb.io.persistent.FileAttributes 393 
PRIORITY_MEDIUM 

of org.dvb.io.persistent.FileAttributes 393 
PRIVATE_DATA_SPECIFIER 

of org.dvb.si.DescriptorTag 418 
prompt( String, int, String) 

of org.dvb.test.DVBTest 739 

R 

RCInterface 

of org.dvb.net.rc 633 
RCInterfaceO 

of org.dvb.net.rc.RCInterface 634 
RCInterfaceManager 

of org.dvb.net.rc 636 
RCInterfaceReleasedEvent 

of org.dvb.net.rc 638 
RCInterfaceReleasedEvent( Object) 

of org.dvb.net.rc.RCInterfaceReleasedEvent 638 
RCInterfaceReservedEvent 

of org.dvb.net.rc 639 
RCInterfaceReservedEvent(Obj ect) 

of org.dvb.net.rc.RCInterfaceReservedEvent 639 
RCPermission 

of org.dvb.net.rc 640 
RCPermission(String) 

of org.dvb.net.rc.RCPermission 640 
RCPermission(String, String) 

of org.dvb.net.rc.RCPermission 641 
read(Preference) 

of org.dvb.user.UserPreferenceManager 407 
read(Preference, Facility) 

of org.dvb.user.UserPreferenceManager 408 
rebind(XletContext, String, Remote) 

of org.dvb.io.ixc.IxcRegistry 745 
receiveEvent(AsynchronousLoadingEvent) 

of org.dvb.dsmcc.AsynchronousLoadingEventListener 554 
receiveNPTStatusEvent(NPTStatusEvent) 

of org.dvb.dsmcc.NPTListener 588 
receiveObj ectCtiangeEvent(Obj ectCliangeEvent) 

of org.dvb.dsmcc.ObjectChangeEventListener 596 
receiveRateCtiangedEvent(NPTRateCtiangeEvent) 

of org.dvb.dsmcc.NPTListener 588 
receiveStreamEvent(StreamEvent) 

of org.dvb.dsmcc.StreamEventListener 612 
receiveUserPreferenceChangeEvent(UserPreferenceChangeEvent) 

of org.dvb.user.UserPreferenceChangeListener 406 
receiveVideoFormatEvent(VideoFormatEvent) 

of org.dvb.media. VideoFormatListener 532 
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releaseO 

of org.dvb.net.rc.ConnectionRCInterface 628 
remove(String) 

of org.dvb.user.Preference 402 
removeAll() 

of org.dvb.user.Preference 402 
removeAUArrowKeysO 

of org.dvb.event.UserEventRepository 386 
removeAUColourKeysO 

of org.dvb.event.UserEventRepository 386 
removeAUNumericKeysO 

of org.dvb.event.UserEventRepository 386 
removeAppStateChangeEventListener(AppStateChangeEventListener) 

of org.dvb. application. AppProxy 655 
removeBouquetMonitoringListener(SIMonitoringListener, int) 

of org.dvb. si. SIDatabase 433 
removeConnectionListener(ConnectionListener) 

of org.dvb.net.rc.ConnectionRCInterface 628 
removeEventPresentFollowingMonitoringListener(SIMonitoringListener, int, int, int) 

of org.dvb. si. SIDatabase 434 
removeEventSctieduleMonitoringListener(SIMonitoringListener, int, int, int) 

of org.dvb. si. SIDatabase 434 
removeExclusiveAccessToAWTEvent(ResourceClient) 

of org.dvb.event.EventManager 374 
removeKey(int) 

of org.dvb.event.UserEventRepository 386 
removeListener(AppsDatabaseEventListener) 

of org.dvb. application. AppsDatabase 662 
removeNetworkMonitoringListener(SIMonitoringListener, int) 

of org.dvb. si. SIDatabase 434 
removeNPTListener(NPTListener) 

of org.dvb.dsmcc.DSMCCStream 567 
removeObjectChangeEventListener(ObjectChangeEventListener) 

of org.dvb.dsmcc.DSMCCObject 562 
removePMTServiceMonitoringListener(SIMonitoringListener, int, int, int) 

of org.dvb. si. SIDatabase 435 
removeResourceStatusEventListener(ResourceStatusListener) 

of org.dvb.event.EventManager 374 

of org.dvb.net.rc.RCInterfaceManager 637 
removeServiceMonitoringListener(SIMonitoringListener, int, int) 

of org.dvb. si. SIDatabase 435 
removeSubtitleListener(SubtitleListener) 

of org.dvb.media.SubtitlingEventControl 524 
removeTextOverflowListener(TextOverflowListener) 

of org.dvb.ui.DVBTextLayoutManager 716 
removeUserEvent(UserEvent) 

of org.dvb.event.UserEventRepository 386 
removeUserEventListener(UserEventListener) 

of org.dvb.event.EventManager 374 
removeUserPreferenceChangeListener(UserPreferenceChangeListener) 

of org.dvb.user.UserPreferenceManager 408 
remove VideoFormatListener(VideoFormatListener) 

of org.dvb.media. VideoFormatControl 530 
render(String, Graphics, HVisible, Insets) 

of org.dvb.ui.DVBTextLayoutManager 716 
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renderBorders(Graphics, HVisible, int) - of org.havi.ui.HExtendedLook 291 
renderVisible(Graphics, HVisible, int) - of org.tiavi.ui.HExtendedLook 291 
RepositoryDescriptor 

of org.dvb.event 376 
reserve(ResourceClient, Object) 

of org.dvb.net.rc.ConnectionRCInterface 629 
resumeO 

of org.dvb. application. AppProxy 655 
retrieveActualSINetwork(stiort, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIDatabase 436 
retrieveActualSIServices(stiort, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIDatabase 436 
retrieveActualSITransportStream(sliort, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIDatabase 437 
retrieveDescriptors(short, Object, SIRetrievalListener) 

of org.dvb. si. SIBouquet 426 

of org.dvb. si. Sllnformation 454 

of org.dvb. si. SINetwork 465 
retrieveDescriptors(short, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIBouquet 427 

of org.dvb. si. Sllnformation 454 

of org.dvb. si. SINetwork 466 
retrieveFollowingSIEvent(short, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIService 479 
retrievePMTElementaryStreams(short, Object, SIRetrievalListener, DvbLocator, short[]) 

of org.dvb. si. SIDatabase 438 
retrievePMTElementaryStreams(short, Object, SIRetrievalListener, int, int, short[]) 

of org.dvb. si. SIDatabase 438 
retrievePMTElementaryStreams(short, Object, SIRetrievalListener, short[]) 

of org.dvb. si.PMTService 423 
retrievePMTService(short, Object, SIRetrievalListener, DvbLocator, short[]) 

of org.dvb. si. SIDatabase 439 
retrievePMTService(short, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIService 479 
retrievePMTServices(short, Object, SIRetrievalListener, int, short[]) 

of org.dvb.si.SIDatabase 440 
retrievePresentSIEvent(short, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIService 480 
retrieveScheduledSIEvents(short, Object, SIRetrievalListener, short[]. Date, Date) 

of org.dvb. si. SIService 481 
retrieveSIBouquets(short, Object, SIRetrievalListener, int, short[]) 

of org.dvb.si.SIDatabase 441 
retrieveSIBouquetTransportStreams(short, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIBouquet 428 
retrieveSINetworks(short, Object, SIRetrievalListener, int, short[]) 

of org.dvb.si.SIDatabase 441 
retrieveSIService(short, Object, SIRetrievalListener, DvbLocator, short[]) 

of org.dvb.si.SIDatabase 442 
retrieveSIService(short, Object, SIRetrievalListener, short[]) 

of org.dvb. si. SIEvent 449 
retrieveSIServices(short, Object, SIRetrievalListener, int, int, int, short[]) 

of org.dvb.si.SIDatabase 443 
retrieveSIServices(short, Object, SIRetrievalListener, short[]) 

of org.dvb.si.SITransportStream 489 
retrieveSITimeFromTDT(short, Object, SIRetrievalListener) 
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of org.dvb.si.SIDatabase 444 
retrieveSITimeFromTOT(short, Object, SIRetrievalListener, short[]) 

of org.dvb.si.SIDatabase 444 
retrieveSITransportStreamDescription(short, Object, SIRetrievalListener, short[]) 

of org.dvb.si.SIDatabase 445 
retrieveSITransportStreams(short, Object, SIRetrievalListener, short[]) 

of org.dvb.si.SINetwork 466 
RUNNING 

of org.dvb.si.SIRunningStatus 475 
RunningApplicationsFilter 

of org.dvb. application 678 
RunningApplicationsFilter() 

of org.dvb. application.RunningApplicationsFilter 678 



SATELLITE_DELIVERY_SYSTEM 

of org.dvb. si.DescriptorTag 418 
SCHEDULED_EVENT 

of org.dvb. si. SIMonitoringType 463 
SECAM 

of org.dvb. si. SIServiceType 483 
selectServiceMediaComponents(Locator) 

of org.dvb.media.DVBMediaSelectControl 510 
ServerDeliveryErrorEvent 

of org.dvb.dsmcc 597 
ServerDeliveryErrorEvent(DSMCCObject) 

of org.dvb.dsmcc. ServerDeliveryErrorEvent 597 
ServerDeliveryException 

of org.dvb.dsmcc 598 
ServerDeliveryExceptionO 

of org.dvb.dsmcc. ServerDeliveryException 598 
ServerDeliveryException(String) 

of org.dvb.dsmcc. ServerDeliveryException 598 
SERVICE 

of org.dvb. si.DescriptorTag 418 

of org.dvb. si. SIMonitoringType 463 
SERVICE_LIST 

of org.dvb. si.DescriptorTag 418 
SERVICE_MOVE 

of org.dvb. si.DescriptorTag 418 
ServiceDomain 

of org.dvb.dsmcc 599 
ServiceDomain() 

of org.dvb.dsmcc. ServiceDomain 599 
ServiceRemovedEvent 

of org.dvb.media515 
ServiceRemovedEvent(Controller) 

of org.dvb.media.ServiceRemovedE vent 515 
ServiceRemovedEvent(Controller, int, int, int, MediaLocator) 

of org.dvb.media.ServiceRemovedEvent 515 
ServiceXFRErrorEvent 

of org.dvb.dsmcc 604 
ServiceXFRErrorEvent(DSMCCObject, ServiceXFRReference) 

of org.dvb.dsmcc. ServiceXFRErrorEvent 604 
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ServiceXFRException 

of org.dvb.dsmcc 606 
ServiceXFRException(byte[], String) 

of org.dvb.dsmcc. ServiceXFRException 606 
ServiceXFRException(Locator, int, String) 

of org.dvb.dsmcc. ServiceXFRException 606 
ServiceXFRReference 

of org.dvb.dsmcc 608 
ServiceXFRReference(byte[], String) 

of org.dvb.dsmcc. ServiceXFRReference 608 
ServiceXFRReference(Locator, int, String) 

of org.dvb.dsmcc. ServiceXFRReference 608 
setClipRegion(Rectangle) 

of org.dvb.media. VideoPresentationControl 536 

of org.dvb.media. VideoTransformation 539 
setColor(Color) 

of org.dvb.ui.DVBGraphics 709 
setDVBComposite(DVBAlptiaComposite) 

of org.dvb.ui.DVBGraphics 710 
setExpirationDate(Date) 

of org.dvb.io.persistent.FileAttributes 394 
setFileAttributes(FileAttributes, File) 

of org.dvb.io.persistent.FileAttributes 394 
setHorizontalAlign(int) 

of org.dvb.ui.DVBTextLayoutManager 717 
setHorizontalTabSpacing(int) 

of org.dvb.ui.DVBTextLayoutManager 717 
setlnsets(Insets) 

of org.dvb.ui.DVBTextLayoutManager 717 
setLetterSpace(int) 

of org.dvb.ui.DVBTextLayoutManager 717 
setLineOrientation(int) 

of org.dvb.ui.DVBTextLayoutManager 717 
setLineSpace(int) 

of org.dvb.ui.DVBTextLayoutManager 717 
setMostFavourite(String) 

of org.dvb.user.Preference 402 
setPermissions(boolean, boolean, boolean, boolean, boolean, boolean) 

of org.dvb.io.persistent.FileAccessPermissions 392 
setPermissions(FileAccessPermissions) 

of org.dvb.io.persistent.FileAttributes 395 
setPriority(int) 

of org.dvb.io.persistent.FileAttributes 395 
setReceiveBufferSize(DatagramSocket, int) 

of org.dvb.net.DatagramSocketBufferControl 617 
setRetrievalMode(int) 

of org.dvb.dsmcc.DSMCCObject 562 
setRGB(int, int, int) 

of org.dvb.ui.DVBBufferedlmage 701 
setRGB(int, int, int, int, int[], int, int) 

of org.dvb.ui.DVBBufferedlmage 701 
setScalingFactors(float, float) 

of org.dvb.media. VideoTransformation 540 
setStartComer(int) 

of org.dvb.ui.DVBTextLayoutManager 718 
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setTarget(ConnectionParameters) 

of org.dvb.net.rc.ConnectionRCInterface 629 
setTargetToDefault() 

of org.dvb.net.rc.ConnectionRCInterface 629 
setTextWrapping(boolean) 

of org.dvb.ui.DVBTextLayoutManager 718 
setVerticalAlign(mt) 

of org.dvb.ui.DVBTextLayoutManager 718 
setVideoPosition(HScreenPoint) 

of org.dvb.media. VideoTransformation 540 
setVideoTransformation(VideoTransformation) 

of org.dvb.media.BackgroundVideoPresentationControl 500 
SHORT_EVENT 

of org.dvb.si.DescriptorTag 418 
SHORT_SMOOTHING_BUFFER 

of org.dvb.si.DescriptorTag 419 
showLook(Graphics, HVisible, int) - of org.havi.ui.HExtendedLook 291 
SIBouquet 

of org.dvb.si 425 
SIDatabase 

of org.dvb.si 429 
SIDatabaseO 

of org.dvb.si. SIDatabase 429 
SIEvent 

of org.dvb.si 446 
SIException 

of org.dvb.si 450 
SIException() 

of org.dvb.si.SIException 450 
SIException( String) 

of org.dvb.si.SIException 450 
SIIUegalArgumentException 

of org.dvb.si 451 
SIIllegalArgumentException() 

of org.dvb.si. SIIUegalArgumentException 451 
SIIllegalArgumentException( String) 

of org.dvb.si. SIIUegalArgumentException 451 
Sllnformation 

of org.dvb.si 452 
SIInvaUdPeriodException 

of org.dvb.si 456 
SIInvaUdPeriodException() 

of org.dvb.si. SIInvaUdPeriodException 456 
SIInvaUdPeriodException(String) 

of org.dvb.si. SIInvaUdPeriodException 456 
Sllterator 

of org.dvb.si 457 
SILackOfResourcesEvent 

of org.dvb.si 458 
SILackOfResourcesEvent(Object, SIRequest) 

of org.dvb.si. SILackOfResourcesEvent 458 
SIMonitoringEvent 
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of org.dvb.si. SIRetrievalEvent 472 
SIRetrievalListener 

of org.dvb.si 474 
SIRunningStatus 

of org.dvb.si 475 
SIService 

of org.dvb.si 476 
SIServiceType 

of org.dvb.si 482 
SISuccessfulRetrieveEvent 

of org.dvb.si 484 
SISuccessfulRetrieveEvent(Object, SIRequest, Sllterator) 

of org.dvb.si. SISuccessfulRetrieveEvent 484 
SITableNotFoundEvent 

of org.dvb.si 485 
SITableNotFoundEvent(Object, SIRequest) 

of org.dvb.si. SITableNotFoundEvent 485 
SITableUpdatedEvent 

of org.dvb.si 486 
SITableUpdatedEvent( Object, SIRequest) 

of org.dvb.si. SITableUpdatedEvent 486 
SITime 

of org.dvb.si 487 
SITransportStream 

of org.dvb.si 488 
SITransportStreamBAT 

of org.dvb.si 490 
SITransportStreamDescription 

of org.dvb.si 491 
SITransportStreamNIT 



ETSI 



782 ETSITS 101 812V1.3.1 (2003-06) 
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